home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / tools / anwender / gnuplot / gnuplot.gih next >
Text File  |  1995-11-25  |  173KB  |  4,383 lines

  1. ?
  2.  `gnuplot` is a command-driven interactive function and data plotting program.
  3.  
  4.  For help on any topic, type `help` followed by the name of the topic.  If the
  5.  precise name of the topic is not known, type `help` and a menu will be given.
  6.  
  7.  The new `gnuplot` user should begin by reading the `introduction` topic (see
  8.  `help introduction`) and the `plot` topic (see `help plot`).  Additional help
  9.  can be obtained from the USENET newsgroup comp.graphics.gnuplot.
  10.  
  11. ?copyright
  12.       Copyright (C) 1986 - 1993   Thomas Williams, Colin Kelley
  13.  
  14.  Permission to use, copy, and distribute this software and its documentation
  15.  for any purpose with or without fee is hereby granted, provided that the
  16.  above copyright notice appears in all copies and that both that copyright
  17.  notice and this permission notice appear in supporting documentation.
  18.  
  19.  Permission to modify the software is granted, but not the right to distribute
  20.  the modified code.  Modifications are to be distributed as patches to the
  21.  released version.
  22.  
  23.  This software is provided "as is" without express or implied warranty.
  24.  
  25.  
  26.    AUTHORS
  27.  
  28.      Original Software:
  29.        Thomas Williams,  Colin Kelley.
  30.  
  31.      Gnuplot 2.0 additions:
  32.          Russell Lang, Dave Kotz, John Campbell.
  33.  
  34.      Gnuplot 3.0 additions:
  35.          Gershon Elber and many others.
  36.  
  37. ?seeking-assistance
  38.  There is a mailing list for `gnuplot` users.  Note, however, that the
  39.  newsgroup
  40.          comp.graphics.gnuplot
  41.  is identical to the mailing list (they both carry the same set of messages).
  42.  We prefer that you read the messages through the newsgroup rather than
  43.  subscribing to the mailing list.  Administrative requests should be sent to
  44.     majordomo@dartmouth.edu
  45.  Send a message with the body (not the subject) consisting of the single word
  46.  "help" (without the quotes) for more details.
  47.  
  48.  The address for mailing to list members is:
  49.    info-gnuplot@dartmouth.edu
  50.  
  51.  Bug reports and code contributions should be mailed to:
  52.    bug-gnuplot@dartmouth.edu
  53.  
  54.  The list of those interested in beta-test versions is:
  55.    info-gnuplot-beta@dartmouth.edu
  56.  
  57.  There is also a World Wide Web page with up-to-date information, including
  58.  known bugs:
  59.     http://www.cs.dartmouth.edu/gnuplot
  60.  
  61.  Before seeking help, please check the FAQ (Frequently Asked Questions) list.
  62.  If you do not have a copy of the FAQ, you may request a copy by email from
  63.  the Majordomo address above, or see the WWW `gnuplot` page.
  64.  
  65.  When posting a question, please include full details of the version of
  66.  `gnuplot`, the machine, and operating system you are using.  A _small_ script
  67.  demonstrating the problem may be useful.  Function plots are preferable to
  68.  datafile plots.  If email-ing to info-gnuplot, please state whether or not
  69.  you are subscribed to the list, so that users who use news will know to email
  70.  a reply to you.  There is a form for such postings on the WWW site.
  71. ?introduction
  72.  `gnuplot` is a command-driven interactive function plotting program.  It is
  73.  case sensitive (commands and function names written in lowercase are not the
  74.  same as those written in CAPS).  All command names may be abbreviated, as
  75.  long as the abbreviation is not ambiguous.  Any number of commands may appear
  76.  on a line, separated by semicolons (;).  Strings are indicated with quotes.
  77.  They may be either single or double quotation marks, e.g.,
  78.  
  79.           load "filename"
  80.           cd 'dir'
  81.  
  82.  although there are some subtle differences (see `syntax` for more details).
  83.  
  84.  Any command-line arguments are assumed to be names of files containing
  85.  `gnuplot` commands, with the exception of standard X11 arguments, which are
  86.  processed first.  Each file is loaded with the `load` command, in the order
  87.  specified.  `gnuplot` exits after the last file is processed.  When no load
  88.  files are named, `gnuplot` enters into an interactive mode.
  89.  
  90.  Commands may extend over several input lines by ending each line but the last
  91.  with a backslash (\).  The backslash must be the LAST character on each line.
  92.  The effect is as if the backslash and newline were not there.  That is, no
  93.  white space is implied, nor is a comment terminated.  Therefore, commenting
  94.  out a continued line comments out the entire command (see `comment`).
  95.  
  96.  In this documentation, curly braces ({}) denote optional arguments and a
  97.  vertical bar (|) separates mutually exclusive choices.  `gnuplot` keywords
  98.  or help topics are indicated by backquotes or `boldface` (where available).
  99.  Angle brackets (<>) are used to mark replaceable tokens.
  100.  
  101.  For help on any topic, type `help` followed by the name of the topic or just
  102.  `help` to get a menu of available topics.
  103.  
  104.  The new `gnuplot` user should begin by reading about the `plot` command (type
  105.  `help plot`).
  106. ?cd
  107.  The `cd` command changes the working directory.
  108.  
  109.  Syntax:
  110.          cd '<directory-name>'
  111.  
  112.  The directory name must be enclosed in quotes.
  113.  
  114.  Examples:
  115.          cd 'subdir'
  116.          cd ".."
  117.  
  118.  DOS users _must_ use single-quotes---backslash [\] has special significance
  119.  inside double-quotes.  For example,
  120.  
  121.          cd "c:\newdata"      fails, but
  122.          cd 'c:\newdata'      works as expected.
  123. ?call
  124.  The `call` command is identical to the load command with one exception: you
  125.  can have up to ten additional parameters to the command (delimited according
  126.  to the standard parser rules) which can be substituted into the lines read
  127.  from the file.  As each line is read from the `call`ed input file, it is
  128.  scanned for the sequence `$` (dollar-sign) followed by a digit (0--9).  If
  129.  found, the sequence is replaced by the corresponding parameter from the
  130.  `call` command line.  If the parameter was specified as a string in the
  131.  `call` line, it is substituted without its enclosing quotes.  `$` followed by
  132.  any character other than a digit will be that character.  E.g. use `$$` to
  133.  get a single `$`.  Providing more than ten parameters on the `call` command
  134.  line will cause an error.  A parameter that was not provided substitutes as
  135.  nothing.  Files being `call`ed may themselves contain `call` or `load`
  136.  commands.
  137.  
  138.  The `call` command MUST be the last command on a multi-command line.
  139.  
  140.  Syntax:
  141.          call "<input-file>" <parameter-0> <parm-1> ... <parm-9>
  142.  
  143.  The name of the input file must be enclosed in quotes, and it is recommended
  144.  that parameters are similarly enclosed in quotes.
  145.  
  146.  Example:
  147.  
  148.  If the file 'calltest.gp' contains the line:
  149.  
  150.      pause 0 "p0=$0 p1=$1 p2=$2 p3=$3 p4=$4 p5=$5 p6=$6 p7=x$7x"
  151.  
  152.  entering the command:
  153.  
  154.      call 'calltest.gp' "abcd" 1.2 + "'quoted'" -- "$2"
  155.  
  156.  will display:
  157.  
  158.      p0=abcd p1=1.2 p2=+ p3='quoted' p4=- p5=- p6=$2 p7=xx
  159.  
  160.  NOTE: there is a clash in syntax with the datafile `using` callback
  161.  operator.  Use $$n to access column n from a datafile inside a `call`ed
  162.  datafile plot.
  163. ?clear
  164.  The `clear` command erases the current screen or output device as specified
  165.  by `set output`.  This usually generates a formfeed on hardcopy devices.  Use
  166.  `set terminal` to set the device type.
  167. ?line-editing
  168. ?editing
  169. ?history
  170. ?command-line-editing
  171.  Command-line editing is supported by the Unix, Atari, VMS, MS-DOS and OS/2
  172.  versions of `gnuplot`.  Also, a history mechanism allows previous commands to
  173.  be edited and re-executed.  After the command line has been edited, a newline
  174.  or carriage return will enter the entire line without regard to where the
  175.  cursor is positioned.
  176.  
  177.  The editing commands are as follows:
  178.  
  179.   `Line-editing`:
  180.  
  181.   ^B moves back a single character.
  182.   ^F moves forward a single character.
  183.   ^A moves to the beginning of the line.
  184.   ^E moves to the end of the line.
  185.   ^H and DEL delete the previous character.
  186.   ^D deletes the current character.
  187.   ^K deletes from current position to the end of line.
  188.   ^L,^R redraws line in case it gets trashed.
  189.   ^U deletes the entire line.
  190.   ^W deletes the last word.
  191.  
  192.   `History`:
  193.  
  194.   ^P moves back through history.
  195.   ^N moves forward through history.
  196.  
  197.  On the IBM PC, the use of a TSR program such as DOSEDIT or CED may be desired
  198.  for line editing.  The default makefile assumes that this is the case;  by
  199.  default `gnuplot` will be compiled with no line-editing capability.  If you
  200.  want to use `gnuplot`'s line editing, set READLINE in the makefile and add
  201.  readline.obj to the link file.  The following arrow keys may be used on the
  202.  IBM PC and Atari versions if readline is used:
  203.  
  204.   Left  Arrow      - same as ^B.
  205.   Right Arrow      - same as ^F.
  206.   Ctrl Left  Arrow - same as ^A.
  207.   Ctrl Right Arrow - same as ^E.
  208.   Up    Arrow      - same as ^P.
  209.   Down  Arrow      - same as ^N.
  210.  
  211.  The Atari version of readline defines some additional key aliases:
  212.  
  213.   Undo            - same as ^L.
  214.   Home            - same as ^A.
  215.   Ctrl Home       - same as ^E.
  216.   Esc             - same as ^U.
  217.   Help            - `help' plus return.
  218.   Ctrl Help       - `help '.
  219.  
  220.  (The readline function in `gnuplot` is not the same as the readline used in
  221.  GNU Bash and GNU Emacs.  It is somewhat compatible, however.)
  222. ?comments
  223.  Comments are supported as follows: a # may appear in most places in a line
  224.  and `gnuplot` will ignore the rest of the line.  It will not have this effect
  225.  inside quotes, inside numbers (including complex numbers), inside command
  226.  substitutions, etc.  In short, it works anywhere it makes sense to work.
  227. ?environment
  228.  A number of shell environment variables are understood by `gnuplot`.  None of
  229.  these are required, but may be useful.
  230.  
  231.  If GNUTERM is defined, it is used as the name of the terminal type to be
  232.  used.  This overrides any terminal type sensed by `gnuplot` on start-up, but
  233.  is itself overridden by the .gnuplot (or equivalent) start-up file (see
  234.  `start-up`) and, of course, by later explicit changes.
  235.  
  236.  On Unix, AmigaDOS, AtariTOS, MS-DOS and OS/2, GNUHELP may be defined to be
  237.  the pathname of the HELP file (gnuplot.gih).
  238.  
  239.  On VMS, the logical name gnuplot$HELP should be defined as the name of the
  240.  help library for `gnuplot`.  The `gnuplot` help can be put inside any system
  241.  help library, allowing access to help from both within and outside `gnuplot`
  242.  if desired.
  243.  
  244.  On Unix, HOME is used as the name of a directory to search for a .gnuplot
  245.  file if none is found in the current directory.  On AmigaDOS, AtariTOS,
  246.  MS-DOS and OS/2, `gnuplot` is used.  On VMS, SYS$LOGIN: is used. See `help
  247.  start-up`.
  248.  
  249.  On Unix, PAGER is used as an output filter for help messages.
  250.  
  251.  On Unix, AtariTOS and AmigaDOS, SHELL is used for the `shell` command.  On
  252.  MS-DOS and OS/2, COMSPEC is used for the `shell` command.
  253.  
  254.  On AmigaDOS, GNUFONT is used for the screen font.  For example:
  255.  "setenv GNUFONT sapphire/14".
  256.  
  257.  On MS-DOS, if the BGI interface is used, the variable `BGI` is used to point
  258.  to the full path of the BGI drivers directory.  Furthermore, SVGA is used to
  259.  name the Super VGA BGI driver in 800x600 resolution and its mode of operation
  260.  as 'Name.Mode'.  E.g., if the Super VGA driver is C:\TC\BGI\SVGADRV.BGI and
  261.  mode 3 is used for 800x600 resolution, then use 'set BGI=C:\TC\BGI' and 'set
  262.  SVGA=SVGADRV.3'.
  263.  
  264.  FIT_SCRIPT may be used to specify a `gnuplot` command to be executed when a
  265.  fit is interrupted---see `fit`.  FIT_LOG specifies the filename of the
  266.  logfile maintained by fit.
  267. ?exit
  268. ?quit
  269.  The commands `exit` and `quit` and the END-OF-FILE character will exit
  270.  `gnuplot`.  Each of these commands will clear the output device (as does
  271.  the `clear` command) before exiting.
  272. ?expressions
  273.  In general, any mathematical expression accepted by C, FORTRAN, Pascal, or
  274.  BASIC is valid.  The precedence of these operators is determined by the
  275.  specifications of the C programming language.  White space (spaces and tabs)
  276.  is ignored inside expressions.
  277.  
  278.  Complex constants are expressed as {<real>,<imag>}, where <real> and <imag>
  279.  must be numerical constants.  For example, {3,2} represents 3 + 2i; {0,1}
  280.  represents `i` itself.  The curly braces are explicitly required here.
  281.  
  282.  Note that gnuplot uses both "real" and "integer" arithmetic, like FORTRAN and
  283.  C.  Integers are entered as "1", "-10", etc; reals as "1.0", "-10.0", "1e1",
  284.  3.5e-1, etc.  The most important difference between the two forms is in
  285.  division: division of integers truncates: 5/2 = 1; division of reals does
  286.  not: 5.0/2.0 = 2.5.  In mixed expressions, integers are "promoted" to reals
  287.  before evaluation: 5/2e1 = 2.5.  The result of division of a negative integer
  288.  by a positive one may vary among compilers.  Try a test like "print -5/2" to
  289.  determine if your system chooses -2 or -3 as the answer.
  290.  
  291.  The real and imaginary parts of complex expressions are always real, whatever
  292.  the form in which they are entered: in {3,2} the "3" and "2" are reals, not
  293.  integers.
  294. ?expressions functions
  295. ?functions
  296.  The functions in `gnuplot` are the same as the corresponding functions in
  297.  the Unix math library, except that all functions accept integer, real, and
  298.  complex arguments, unless otherwise noted.  The `sgn` function is also
  299.  supported, as in BASIC.
  300. ?expressions functions abs
  301. ?functions abs
  302. ?abs
  303.  The `abs` function returns the absolute value of its argument.  The returned
  304.  value is of the same type as the argument.
  305.  
  306.  For complex arguments, abs(x) is defined as the length of x in the complex
  307.  plane [i.e.,  sqrt(real(x)**2 + imag(x)**2) ].
  308. ?expressions functions acos
  309. ?functions acos
  310. ?acos
  311.  The `acos` function returns the arc cosine (inverse cosine) of its argument.
  312.  `acos` returns its argument in radians.
  313. ?expressions functions arg
  314. ?functions arg
  315. ?arg
  316.  The `arg` function returns the phase of a complex number, in radians.
  317. ?expressions functions asin
  318. ?functions asin
  319. ?asin
  320.  The `asin` function returns the arc sin (inverse sin) of its argument.
  321.  `asin` returns its argument in radians.
  322. ?expressions functions atan
  323. ?functions atan
  324. ?atan
  325.  The `atan` function returns the arc tangent (inverse tangent) of its
  326.  argument.  `atan` returns its argument in radians.
  327. ?expressions functions besj0
  328. ?functions besj0
  329. ?besj0
  330.  The `besj0` function returns the j0th Bessel function of its argument.
  331.  `besj0` expects its argument to be in radians.
  332. ?expressions functions besj1
  333. ?functions besj1
  334. ?besj1
  335.  The `besj1` function returns the j1st Bessel function of its argument.
  336.  `besj1` expects its argument to be in radians.
  337. ?expressions functions besy0
  338. ?functions besy0
  339. ?besy0
  340.  The `besy0` function returns the y0th Bessel function of its argument.
  341.  `besy0` expects its argument to be in radians.
  342. ?expressions functions besy1
  343. ?functions besy1
  344. ?besy1
  345.  The `besy1` function returns the y1st Bessel function of its argument.
  346.  `besy1` expects its argument to be in radians.
  347. ?expressions functions ceil
  348. ?functions ceil
  349. ?ceil
  350.  The `ceil` function returns the smallest integer that is not less than its
  351.  argument.  For complex numbers, `ceil` returns the smallest integer not less
  352.  than the real part of its argument.
  353. ?expressions functions column
  354. ?functions column
  355. ?column
  356.  `column(x)` may be used only in expressions as part of `using` manipulations
  357.  to fits or datafile plots.  See `plot datafile using`.
  358. ?expressions functions cos
  359. ?functions cos
  360. ?cos
  361.  The `cos` function returns the cosine of its argument.  `cos` expects its
  362.  argument to be in radians.
  363. ?expressions functions cosh
  364. ?functions cosh
  365. ?cosh
  366.  The `cosh` function returns the hyperbolic cosine of its argument.  `cosh`
  367.  expects its argument to be in radians.
  368. ?expressions functions erf
  369. ?functions erf
  370. ?erf
  371.  The `erf` function returns the error function of the real part of its
  372.  argument.  If the argument is a complex value, the imaginary component is
  373.  ignored.
  374. ?expressions functions erfc
  375. ?functions erfc
  376. ?erfc
  377.  The `erfc` function returns 1.0 - the error function of the real part of its
  378.  argument.  If the argument is a complex value, the imaginary component is
  379.  ignored.
  380. ?expressions functions exp
  381. ?functions exp
  382. ?exp
  383.  The `exp` function returns the exponential function of its argument (`e`
  384.  raised to the power of its argument).  On some implementations (notably
  385.  suns), exp(-x) returns undefined for very large x.  A user-defined function
  386.  like safe(x) = x<-100 ? 0 : exp(x) might prove useful in these cases.
  387. ?expressions functions floor
  388. ?functions floor
  389. ?floor
  390.  The `floor` function returns the largest integer not greater than its
  391.  argument.  For complex numbers, `floor` returns the largest integer not
  392.  greater than the real part of its argument.
  393. ?expressions functions gamma
  394. ?functions gamma
  395. ?gamma
  396.  The `gamma` function returns the gamma function of the real part of its
  397.  argument.  For integer n, gamma(n+1) = n!.  If the argument is a complex
  398.  value, the imaginary component is ignored.
  399. ?expressions functions ibeta
  400. ?functions ibeta
  401. ?ibeta
  402.  The `ibeta` function returns the incomplete beta function of the real parts
  403.  of its arguments. p, q > 0 and x in [0:1].  If the arguments are complex,
  404.  the imaginary components are ignored.
  405. ?expressions functions inverf
  406. ?functions inverf
  407. ?inverf
  408.  The `inverf` function returns the inverse error function of the real part
  409.  of its argument.
  410. ?expressions functions igamma
  411. ?functions igamma
  412. ?igamma
  413.  The `igamma` function returns the incomplete gamma function of the real
  414.  parts of its arguments.  a > 0 and x >= 0.  If the arguments are complex,
  415.  the imaginary components are ignored.
  416. ?expressions functions imag
  417. ?functions imag
  418. ?imag
  419.  The `imag` function returns the imaginary part of its argument as a real
  420.  number.
  421. ?expressions functions invnorm
  422. ?functions invnorm
  423. ?invnorm
  424.  The `invnorm` function returns the inverse normal distribution function of
  425.  the real part of its argument.
  426. ?expressions functions int
  427. ?functions int
  428. ?int
  429.  The `int` function returns the integer part of its argument, truncated
  430.  toward zero.
  431. ?expressions functions lgamma
  432. ?functions lgamma
  433. ?lgamma
  434.  The `lgamma` function returns the natural logarithm of the gamma function
  435.  of the real part of its argument.  If the argument is a complex value, the
  436.  imaginary component is ignored.
  437. ?expressions functions log
  438. ?functions log
  439. ?log
  440.  The `log` function returns the natural logarithm (base `e`) of its argument.
  441. ?expressions functions log10
  442. ?functions log10
  443. ?log10
  444.  The `log10` function returns the logarithm (base 10) of its argument.
  445. ?expressions functions norm
  446. ?functions norm
  447. ?norm
  448.  The `norm` function returns the normal distribution function (or Gaussian)
  449.  of the real part of its argument.
  450. ?expressions functions rand
  451. ?functions rand
  452. ?rand
  453.  The `rand` function returns a pseudo random number in the interval [0:1]
  454.  using the real part of its argument as a seed.  If seed < 0, the sequence
  455.  is (re)initialized.  If the argument is a complex value, the imaginary
  456.  component is ignored.
  457. ?expressions functions real
  458. ?functions real
  459. ?real
  460.  The `real` function returns the real part of its argument.
  461. ?expressions functions sgn
  462. ?functions sgn
  463. ?sgn
  464.  The `sgn` function returns 1 if its argument is positive, -1 if its argument
  465.  is negative, and 0 if its argument is 0.  If the argument is a complex value,
  466.  the imaginary component is ignored.
  467. ?expressions functions sin
  468. ?functions sin
  469. ?sin
  470.  The `sin` function returns the sine of its argument.  `sin` expects its
  471.  argument to be in radians.
  472. ?expressions functions sinh
  473. ?functions sinh
  474. ?sinh
  475.  The `sinh` function returns the hyperbolic sine of its argument.  `sinh`
  476.  expects its argument to be in radians.
  477. ?expressions functions sqrt
  478. ?functions sqrt
  479. ?sqrt
  480.  The `sqrt` function returns the square root of its argument.
  481. ?expressions functions tan
  482. ?functions tan
  483. ?tan
  484.  The `tan` function returns the tangent of its argument.  `tan` expects
  485.  its argument to be in radians.
  486. ?expressions functions tanh
  487. ?functions tanh
  488. ?tanh
  489.  The `tanh` function returns the hyperbolic tangent of its argument.  `tanh`
  490.  expects its argument to be in radians.
  491. ?expressions functions valid
  492. ?functions valid
  493. ?valid
  494.  `valid(x)` may be used only in expressions as part of `using` manipulations
  495.  to fits or datafile plots.  See `plot datafile using`.
  496. ?expressions operators
  497. ?operators
  498.  The operators in `gnuplot` are the same as the corresponding operators in the
  499.  C programming language, except that all operators accept integer, real, and
  500.  complex arguments, unless otherwise noted.  The ** operator (exponentiation)
  501.  is supported, as in FORTRAN.
  502.  
  503.  Parentheses may be used to change order of evaluation.
  504. ?expressions operators binary
  505. ?operators binary
  506. ?binary
  507.  The following is a list of all the binary operators and their usages:
  508.  
  509.   Symbol      Example      Explanation
  510.    **          a**b          exponentiation
  511.    *           a*b           multiplication
  512.    /           a/b           division
  513.    %           a%b         * modulo
  514.    +           a+b           addition
  515.    -           a-b           subtraction
  516.    ==          a==b          equality
  517.    !=          a!=b          inequality
  518.    &           a&b         * bitwise AND
  519.    ^           a^b         * bitwise exclusive OR
  520.    |           a|b         * bitwise inclusive OR
  521.    &&          a&&b        * logical AND
  522.    ||          a||b        * logical OR
  523.    ?:          a?b:c       * ternary operation
  524.  
  525.  (*) Starred explanations indicate that the operator requires integer
  526.  arguments.
  527.  
  528.  Logical AND (&&) and OR (||) short-circuit the way they do in C.  That is,
  529.  the second && operand is not evaluated if the first is false; the second ||
  530.  operand is not evaluated if the first is true.
  531.  
  532.  The ternary operator behaves as it does in C.  The first argument (a) is
  533.  evaluated. If it is true (non-zero), the second argument (b) is evaluated and
  534.  returned; otherwise the third argument (c) is evaluated and returned.
  535. ?expressions operators unary
  536. ?operators unary
  537. ?unary
  538.  The following is a list of all the unary operators and their usages:
  539.  
  540.   Symbol     Example      Explanation
  541.    -           -a          unary minus
  542.    +           +a          unary plus (no-operation)
  543.    ~           ~a        * one's complement
  544.    !           !a        * logical negation
  545.    !           a!        * factorial
  546.    $           $3        * call arg/column during `using` manipulation
  547.  (*) Starred explanations indicate that the operator requires an integer
  548.  argument.
  549.  
  550.  The factorial operator returns a real number to allow a greater range.
  551. ?fit
  552.  This implementation incorporates the capability of nonlinear least squares
  553.  fitting using the Marquardt-Levenberg Algorithm.  It may fit any user-defined
  554.  function to any set of data pairs (x,y).  x, y and the function's return type
  555.  MUST be real!  Any variable occurring in the function body may serve as a fit
  556.  parameter (fitting functions without adjustable parameters make no sense).
  557.  
  558.  Syntax:
  559.          fit {range} <function> '<datafile>' {datafile-modifiers} \
  560.              via {'<parameter file>' | <var1>,<var2>,...}
  561.  
  562.  Notice that `via` is now a required keyword, to distinguish it from a scanf
  563.  format string.
  564.  
  565.  {[range]} is [ {variable=} { <min> } { :<max> } ], allowing the range of the
  566.  fit to be limited temporarily in a manner analogous to `plot`.  <function> is
  567.  any valid `gnuplot` expression, although it is usual to use a previously
  568.  user-defined function of the form f(x).  <datafile> is treated as in the
  569.  `plot` command.  All the modifiers for datafiles (`using`, `every`,...) in
  570.  `plot` are available here---see `plot datafile` for full details.  The
  571.  default column for x is 1 for y is 2.  They may be changed by the `using x:y`
  572.  mechanism.  If a third column or expression is specified with `using`,
  573.  uncertainties are read for each y value, to be used as weights during the
  574.  fit.  Otherwise all data are weighted equally.  The start parameters may be
  575.  specified in a (load-) file wherein each line is of the form:
  576.  
  577.     varname = value
  578.  
  579.  Comments, marked by '#', and blank lines are permissible.  The form
  580.  
  581.     varname = value       # FIXED
  582.  
  583.  means that the variable is treated as a `fixed parameter` that is initialized
  584.  but will not be adjusted.  It is not necessary (but sometimes useful for
  585.  clarity) to specify them at all.  The keyword '# FIXED' has to appear in
  586.  exactly this form.
  587.  
  588.  The other means of specifying the adjustable parameters is to provide a
  589.  comma-separated list of variable names after the `via` keyword.  If any of
  590.  these variables do not yet exist within the current `gnuplot` session, they
  591.  are created with an initial value of 1.0, but the fit is more likely to
  592.  converge if a more appropriate starting value is given.  If this form is
  593.  used, it may prove beneficial to iterate the fit, allowing only one or two
  594.  variables to be adjusted at a time until a reasonably close fit is obtained,
  595.  before allowing `fit` to vary all parameters.
  596.  
  597.  After each iteration step, detailed information is given about the fit's
  598.  state, both on the screen and on a logfile "fit.log".  This file will never
  599.  be erased but always appended to so that the fit's history isn't lost.  After
  600.  each iteration step, the fit may be interrupted by pressing Ctrl-C (any key
  601.  BUT Ctrl-C under MSDOS and Atari Multitasking Systems).  Then you have the
  602.  options of stopping (and accepting the current parameter values), continuing
  603.  the iteration of the fit, or executing a `gnuplot` command specified by an
  604.  environment variable FIT_SCRIPT.  A `plot` or `load` command may be useful in
  605.  this context.
  606.  
  607.  Special `gnuplot` variables:
  608.     FIT_INDEX  contains the current data point number during execution,
  609.                starting with 1.  You may use it in your fit function to
  610.                implement multiple-branch fits.
  611.     FIT_LIMIT  may be specified to change the default epsilon limit (1e-5).
  612.                When the sum of squared residuals changes between two iteration
  613.                steps by less than a factor of this number, the fit is
  614.                considered to have 'converged'.
  615.  
  616.  (FIT_SKIP was available in previous released of gnufit.  Its functionality
  617.  is now obtained using the `every` modifier for datafiles.)
  618.  
  619.  Environment variables:
  620.     FIT_LOG    changes the logfile's path from './fit.log' (write permission
  621.                is necessary).
  622.     FIT_SCRIPT specifies a command to be executed after an user interrupt.
  623.  
  624.  Examples:
  625.     f(x) = a*x**2 + b*x + c
  626.     fit f(x) 'measured.dat' via 'start.par'
  627.     fit f(x) 'measured.dat' using 3:($7-5) via 'start.par'
  628.     fit f(x) './data/trash.dat' using 1:2:3 via a, b, c
  629.  
  630.  SEE ALSO: `update`
  631. ?help
  632.  The `help` command displays on-line help. To specify information on a
  633.  particular topic use the syntax:
  634.  
  635.          help {<topic>}
  636.  
  637.  If <topic> is not specified, a short message is printed about `gnuplot`.
  638.  After help for the requested topic is given, a menu of subtopics is given;
  639.  help for a subtopic may be requested by typing its name, extending the help
  640.  request.  After that subtopic has been printed, the request may be extended
  641.  again or you may go back one level to the previous topic.  Eventually, the
  642.  `gnuplot` command line will return.
  643.  
  644.  If a question mark (?) is given as the topic, the list of topics currently
  645.  available is printed on the screen.
  646. ?if
  647.  The `if` command allows commands to be executed conditionally.
  648.  
  649.  Syntax:
  650.          if (<condition>) <command-line>
  651.  
  652.  <condition> will be evaluated.  If it is true (non-zero), then the command(s)
  653.  of the <command-line> will be executed.  If <condition> is false (zero), then
  654.  the entire <command-line> is ignored.  Note that use of ';' to allow multiple
  655.  commands on the same line will NOT end the conditionalized commands.
  656.  
  657.  Examples:
  658.  
  659.       pi=3
  660.       if (pi!=acos(-1)) pause 0 "?Fixing pi!";pi=acos(-1);show variables
  661.  
  662.  will display:
  663.  
  664.       ?Fixing pi!
  665.  
  666.               Variables:
  667.               pi = 3.14159
  668.  but
  669.       if (1==2) pause 0 "Never see this";pause 0 "Or this either"
  670.  
  671.  will not display anything.
  672. ?load
  673.  The `load` command executes each line of the specified input file as if it
  674.  had been typed in interactively.  Files created by the `save` command can
  675.  later be `load`ed.  Any text file containing valid commands can be created
  676.  and then executed by the `load` command.  Files being `load`ed may themselves
  677.  contain `load` or `call` commands.  See `comment` for information about
  678.  comments in commands.
  679.  
  680.  The `load` command MUST be the last command on a multi-command line.
  681.  
  682.  Syntax:
  683.          load "<input-file>"
  684.  
  685.  The name of the input file must be enclosed in quotes.
  686.  
  687.  Examples:
  688.  
  689.          load 'work.gnu'
  690.          load "func.dat"
  691.  
  692.  The `load` command is performed implicitly on any file names given as
  693.  arguments to `gnuplot`.  These are loaded in the order specified, and
  694.  then `gnuplot` exits.  See also `call`.
  695. ?pause
  696.  The `pause` command displays any text associated with the command and then
  697.  waits a specified amount of time or until the carriage return is pressed.
  698.  `pause` is especially useful in conjunction with `load` files.
  699.  
  700.  Syntax:
  701.          pause <time> {"<string>"}
  702.  
  703.  <time> may be any integer constant or expression.  Choosing -1 will wait
  704.  until a carriage return is hit, zero (0) won't pause at all, and a positive
  705.  integer will wait the specified number of seconds.
  706.  
  707.  Note: Since `pause` is not part of the plot, it may interact with different
  708.  device drivers differently (depending upon how text and graphics are mixed).
  709.  
  710.  Examples:
  711.          pause -1    # Wait until a carriage return is hit
  712.          pause 3     # Wait three seconds
  713.          pause -1  "Hit return to continue"
  714.          pause 10  "Isn't this pretty?  It's a cubic-spline."
  715.  
  716. ?plot
  717. ?splot
  718.  `plot` and `splot` are the primary commands of the program. They plot
  719.  functions and data in many, many ways.  `plot` is used to plot 2-d
  720.  functions and data, while `splot` plots 3-d surfaces and data.
  721.  
  722.  Syntax:
  723.       plot {ranges} {<function> | {"<datafile>" {datafile-modifiers}}} \
  724.               {title} {style} {, {second,} <function> {title} {style}...}
  725.       splot {ranges} {<function> | {"<datafile>" {datafile-modifiers}}} \
  726.               {title} {style} {, <function> {title} {style}...}
  727.  
  728.  where either a <function> or the name of a data file enclosed in quotes is
  729.  supplied.  A function is a mathematical expression, or a pair (`plot`) or
  730.  triple (`splot`) of mathematical expressions in the case of parametric
  731.  functions.  It is also possible to insert user-defined function definitions
  732.  and variable assignments into the list of plots.
  733.  
  734.  For `plot` there are two independent sets of axes available: the keywords
  735.  `first` and `second` can be used to change the axes for which the following
  736.  plots should be scaled.  `first` refers to the axes on the bottom and
  737.  left; `second` to those on the top and right.  Ranges specified on the `plot`
  738.  command apply only to the first set of axes.
  739.  
  740.  The `second` option has not been implemented for `splot`.
  741.  
  742.  `plot` and `splot` commands can be as simple as
  743.  
  744.          plot sin(x)
  745.  
  746.  and
  747.  
  748.          splot x * y
  749.  
  750.  or as complex as (!)
  751.  
  752.   plot [t=1:10] [-pi:pi*2] tan(t), "data.1" using 2:($3/$4) with lines, \
  753.         f(x)=x**p, p=2, second, f(t) with points
  754. ?plot data-file
  755. ?plot datafile
  756. ?splot data-file
  757. ?splot datafile
  758. ?data-file
  759. ?datafile
  760. ?data
  761.  Discrete data contained in a file can be displayed by specifying the name of
  762.  the data file (enclosed in quotes) on the `plot` or `splot` command line.
  763.  Data files should contain one data point per line.  Lines beginning with #
  764.  (or ! on VMS) will be treated as comments and ignored.  For `plot`s, each
  765.  data point represents an (x,y) pair.  For `splot`s, each point is an (x,y,z)
  766.  triple.  For `plot`s with error bars (see `set style errorbars`), each data
  767.  point is (x,y,ydelta), (x,y,ylow,yhigh), (x,y,xdelta), (x,y,xlow,xhigh), or
  768.  (x,y,xlow,xhigh,ylow,yhigh).  In all cases, the numbers on each line of a
  769.  data file must be separated by white space (one or more blanks or tabs),
  770.  unless a format specifier is provided by the `using` option.  This white
  771.  space divides each line into columns.
  772.  
  773.  For `plot`s, only one column (the y value) need be provided.  For `splot`s,
  774.  provide either one column (z) or three (x,y,z).  (It is no longer necessary
  775.  to specify `parametric` mode for three-column splots.)  If x (and y) are
  776.  omitted, `gnuplot` provides integer values starting at 0.
  777.  
  778.  In `s/plot` datafiles, blank lines (lines with no characters other than a
  779.  line feed or carriage return) are significant---pairs of blank lines separate
  780.  `index`es (see `plot datafile index`).  Data separated by double blank lines
  781.  are treated as if they were in separate data files.
  782.  
  783.  Single blank lines separate points in a `plot`, or isolines in a `splot`.
  784.  No line will join points separated by a blank line in either a `plot` or
  785.  `splot`.  For `splot`, if all isolines (groups of contiguous points) are of
  786.  equal length, `gnuplot` will draw cross-isolines in the opposite direction.
  787.  This is termed "grid data", and is required for contouring (`set contour`)
  788.  and hidden-line removal (`set hidden3d`).
  789.  
  790.  If autoscaling has been enabled (`set autoscale`), the axes are automatically
  791.  extended to include all datapoints, with a whole number of tic marks if tics
  792.  are being drawn.  This has two consequences: i) For `splot`, the corner of
  793.  the surface may not coincide with the corner of the base.  In this case, no
  794.  vertical line is drawn.  ii) When plotting data with the same x range on a
  795.  dual-axis plot, the x co-ordinates may not coincide if the x2tics are not
  796.  being drawn.  This is because the x axis has been autoextended to a whole
  797.  number of tics, but the x2 axis has not.  The following example illustrates
  798.  the problem:
  799.  
  800.        reset; plot first, '-', second, '-'
  801.        1 1
  802.        19 19
  803.        e
  804.        1 1
  805.        19 19
  806.        e
  807. ?plot data-file example
  808. ?plot datafile example
  809. ?datafile example
  810.  This example compares the data in the file population.dat to a theoretical
  811.  curve:
  812.  
  813.          pop(x) = 103*exp((1965-x)/10)
  814.          plot [1960:1990] 'population.dat', pop(x)
  815.  
  816.  The file population.dat might contain:
  817.  
  818.          # Gnu population in Antarctica since 1965
  819.          1965   103
  820.          1970   55
  821.          1975   34
  822.          1980   24
  823.          1985   10
  824.  
  825.  
  826.  
  827.  A simple example of plotting a 3-d data file is
  828.  
  829.          splot 'glass.dat'
  830.  
  831.  where the file datafile.dat might contain:
  832.  
  833.          # The valley of the Gnu.
  834.          0 0 10
  835.          0 1 10
  836.          0 2 10
  837.  
  838.          1 0 10
  839.          1 1 5
  840.          1 2 10
  841.  
  842.          2 0 10
  843.          2 1 1
  844.          2 2 10
  845.  
  846.          3 0 10
  847.          3 1 0
  848.          3 2 10
  849.  
  850.  Note datafile.dat defines a 4 by 3 grid ( 4 rows of 3 points each ).  Rows
  851.  are separated by blank lines.
  852.  
  853.  Note also that the x value is held constant within each isoline.  If you
  854.  instead keep y constant, and plot with hidden-line removal enabled, you will
  855.  find that the surface is drawn 'inside-out'.
  856.  
  857.  Actually it is not necessary to keep the x values constant within an isoline,
  858.  nor is it necessary to keep the y values the same along the perpendicular
  859.  isolines.  `gnuplot` requires only that the number of points be the same
  860.  along each isoline.
  861. ?plot data-file special-filenames
  862. ?plot datafile special-filenames
  863. ?datafile special-filenames
  864.  
  865.  A special filename of `'-'` specifies that the data are inline; i.e., they
  866.  follow the command.  Only the data follow the command; `plot` options like
  867.  filters, titles, and line styles remain on the 'plot' command line.  This is
  868.  similar to << in unix shell script, and $DECK in VMS DCL.  The data are
  869.  entered as though they are being read from a file, one data point per record.
  870.  The letter "e" at the start of the first column terminates data entry.  The
  871.  `using` option can be applied to these data---using it to filter them through
  872.  a function might make sense, but selecting columns probably doesn't!
  873.  
  874.  N.B.---use of
  875.  
  876.    plot '-' ; ... ; replot
  877.  
  878.  is not recommended---`gnuplot` does not store the inline data internally.
  879.  Since `replot` appends new information to the previous `plot` and then
  880.  executes the modified command, the `'-'` will ask once more for the data.
  881.  `'-'` is intended for situations where it is useful to have data and commands
  882.  together, e.g., when `gnuplot` is run as a sub-process of some front-end
  883.  application.  Some of the demos, for example, might use this feature.
  884.  
  885.  A blank filename ('') specifies that the previous filename should be reused.
  886.  This can be useful with things like
  887.  
  888.   plot 'a/very/very/long/filename' using 1:2, '' using 1:3, '' using 1:4
  889.  
  890.  On some computer systems with a popen function (Unix), the datafile can be
  891.  piped through a shell command by starting the file name with a '<'.  For
  892.  example
  893.  
  894.          pop(x) = 103*exp(-x/10)
  895.          plot "< awk '{print $1-1965, $2}' population.dat", pop(x)
  896.  
  897.  would plot the same information as the first population example but with
  898.  years since 1965 as the x axis.  If you want to execute this example, you
  899.  have to delete all comments from the data file above or substitute the
  900.  following command for the first part of the command above (the part up to
  901.  the comma):
  902.  
  903.          plot "< awk '$0 !~ /^#/ {print $1-1965, $2}' population.dat"
  904.  
  905.  While this approach is most flexible, it is possible to achieve simple
  906.  filtering with the `using` or `thru` keywords.
  907. ?binary
  908. ?binary data
  909. ?binary files
  910.  In previous versions, `gnuplot` dynamically detected binary data files.  It
  911.  is now necessary to specify the keyword `binary` directly after the filename.
  912.  Currently, binary data is supported only for `splot`, since a format for
  913.  binary data in 2-d has not been designed.
  914.  
  915.  Single precision floats are stored in a binary file as follows:
  916.  
  917.        <ncols> <x0> <x1> <x2> ...
  918.        <y0> <z0,0> <z0,1> <z0,2> ...
  919.        <y1> <z1,0> <z1,1> <z1,2> ...
  920.  
  921.  which are converted into triplets:
  922.  
  923.        <x0> <y0> <z0,0>
  924.        <x0> <y1> <z0,1>
  925.        <x0> <y2> <z0,2>
  926.  
  927.        <x1> <y0> <z1,0>
  928.        <x1> <y1> <z1,1>
  929.        <x1> <y2> <z1,2>
  930.  
  931.  These triplets are then converted into `gnuplot` iso-curves and then
  932.  `gnuplot` proceeds in the usual manner to do the rest of the plotting.
  933.  
  934.  A collection of matrix and vector manipulation routines (in C) is provided
  935.  in `binary.c`.  The routine to write binary data is
  936.  
  937.   int fwrite_matrix(file,m,nrl,nrl,ncl,nch,row_title,column_title)
  938.  
  939.  An example of using these routines is provided in the file `bf_test.c`, which
  940.  generates binary files for the demo file `demo/binary.dem`.
  941.  
  942.  The `index` keyword is not supported, since the file format allows only one
  943.  surface per file.  The `every` and `using` filters are supported.  `using`
  944.  operates as if the data were read in the above triplet form.
  945. ?plot data-file every
  946. ?plot datafile every
  947. ?splot data-file every
  948. ?splot datafile every
  949. ?every
  950.  The `every` keyword allows a periodic sampling of a data set to be plotted.
  951.  
  952.        plot 'file' every a{:b{:c{:d}}}
  953.  
  954.  This selects every a-th point in every b'th (iso)line, starting at point c in
  955.  line d.  To plot a single line from a 3-d datafile, one trick is to set d to
  956.  the required line, and set b very large, so that no subsequent lines will be
  957.  selected.  If `every` is not specified, all points are plotted.
  958. ?plot data-file index
  959. ?plot datafile index
  960. ?splot data-file index
  961. ?splot datafile index
  962. ?index
  963.  The `index` keyword allows only some of the data sets in a multi-data-set
  964.  file to be plotted.
  965.  
  966.       plot 'file' index m{:n}
  967.  
  968.  Data sets (surfaces for `splot`) are separated by pairs of blank lines.
  969.  `index m` selects only set m, or `index m:n` selects sets in the range m
  970.  to n.  If `index` is not specified, all sets are plotted.
  971.  
  972.  Example:
  973.           plot 'file' index 4:5
  974. ?plot data-file thru
  975. ?plot datafile thru
  976. ?splot data-file thru
  977. ?splot datafile thru
  978. ?thru
  979.  The `thru` function is provided for backward compatibility.
  980.  
  981.  Syntax:
  982.          plot 'file' thru f(x)
  983.  
  984.  It is equivalent to `plot 'file' using 1:(f($2))`.  While the latter appears
  985.  more complex, it is much more flexible.
  986.  
  987.  The more natural
  988.  
  989.    plot 'file' thru f(y)
  990.  
  991.  also works (i.e. you can use y as the dummy variable).
  992.  
  993.  `thru` is parsed for `splot` and `fit` but has no effect.
  994. ?plot data-file using
  995. ?plot datafile using
  996. ?splot data-file using
  997. ?splot datafile using
  998. ?using
  999.  The most common datafile modifier is `using`.
  1000.  
  1001.  Syntax:
  1002.          plot 'file' using { spec:spec:... } {'format'}
  1003.  
  1004.  If a format is specified, each datafile line is read using the c library's
  1005.  scanf function, with the specified format string.  Otherwise the line is read
  1006.  and broken into columns at spaces or tabs.  A format cannot be specified if
  1007.  time-format data is being used  (see `set data time`).
  1008.  
  1009.  The resulting array of data is then sorted into columns according to the
  1010.  specs.  Each spec is either a simple column number, which selects the datum,
  1011.  or an expression enclosed in round brackets (parentheses).  The expression
  1012.  can use $1 to access the first item read, $2 for the second item, and so on.
  1013.  It can also use `column(x)` and `valid(x)` where x is an arbitrary expression
  1014.  resulting in an integer.  `column(x)` returns the x'th datum; `valid(x)`
  1015.  tests that datum x is a valid number.  A column number of 0 generates a
  1016.  number increasing (from zero) with each point, reset at double blank lines.
  1017.  
  1018.  `plot 'file' using 1` is identical to `plot 'file' using 0:1`.
  1019.  
  1020.  N.B.---the `call` command also uses $'s as a special character.
  1021.  
  1022.  The interpretation of the columns depends on the plot and style.  For
  1023.  `splot`, a single column is z, or three columns are (x,y,z) (unless `set
  1024.  mapping` has been used).  For `plot`, a single column is y.  For `plot` or
  1025.  `fit`, the first two columns are x and y; additional columns are usually
  1026.  errors in x and/or y.  See `set style` for more details about the structure
  1027.  of files containing error information.
  1028.  
  1029.  Examples:
  1030.  
  1031.  This creates a plot of the sum of the 2nd and 3rd data against the first:
  1032.  (The format string specifies comma- rather than space-separated columns.)
  1033.      plot 'file' using 1:($2+$3) '%lf,%lf,%lf'
  1034.  
  1035.  In this example the data are read from the file "MyData" using a more
  1036.  complicated format:
  1037.      plot "MyData" using "%*lf%lf%*20[^\n]%lf"
  1038.  
  1039.  The meaning of this format is:
  1040.  
  1041.        %*lf        ignore the first number
  1042.        %lf         read in the second and assign to x
  1043.        %*20[^\n]   ignore 20 non-newline characters
  1044.        %lf         read in the y value
  1045.  
  1046.  Note that the use of newline (\n) requires use of double-quotes rather than
  1047.  single-quotes.
  1048.  
  1049.  One trick is to use the ternary `?:` operator to filter data:
  1050.  
  1051.        plot 'file' using 1:($3>10 ? $2 : 1/0)
  1052.  
  1053.  which plots the datum in column two against that in column one provided
  1054.  the datum in column three exceeds ten.  `1/0` is undefined; `gnuplot`
  1055.  quietly ignores undefined points, so unsuitable points are suppressed.
  1056.  
  1057.  In fact, you can use a constant expression for the column number, provided
  1058.  it doesn't start with an opening bracket.  Something like
  1059.  
  1060.       `using 0+`(complicated expression)
  1061.  
  1062.  can be used.  The crucial point is that the expression is evaluated once if
  1063.  it doesn't start with a bracket, or once for each data point read if it does
  1064.  start with a bracket.
  1065.  
  1066.  If timeseries data are being used, the time can span multiple columns.  The
  1067.  starting column should be specified.  Note that the spaces within the time
  1068.  must be included when calculating starting columns for other data.  E.g., if
  1069.  the first element on a line is a time with an embedded space, the y value
  1070.  should be specified as column three.
  1071.  
  1072.  It should be noted that `plot 'file', plot 'file' using 1:2`, and `plot
  1073.  'file' using ($1):($2)` can be subtly different: 1) if `file` has some lines
  1074.  with one column and some with two, the first will invent x values when they
  1075.  are missing, the second will quietly ignore the lines with one column, and
  1076.  the third will store an undefined value for lines with one point (so that in
  1077.  a plot with lines, no line joins points across the bad point); 2) if a line
  1078.  contains text at the first column, the first will abort the plot on an error,
  1079.  but the second and third should quietly skip the garbage.
  1080.  
  1081.  In fact, it is often possible to plot a file with lots of lines of garbage at
  1082.  the top simply by specifying
  1083.  
  1084.     plot 'file' using 1:2
  1085.  
  1086.  If you want to leave text in your data files, it is always safe to put the
  1087.  comment character (#) in the first column of the text lines.
  1088. ?plot errorbars
  1089. ?errorbars
  1090.  Error bars are supported for 2-d data file plots by reading one to
  1091.  four additional columns specifying ydelta or ylow and yhigh for
  1092.  yerrorbars or xdelta or xlow and xhigh for xerrorbars or xdelta, ydelta
  1093.  or xlow, xhigh, ylow, yhigh for xyerrorbars or boxxyerrorbars.
  1094.  No support exists for any error bars for `splot`s.
  1095.  
  1096.  In the default situation, `gnuplot` expects to see three, four, or six
  1097.  numbers on each line of the data file---either (x, y, ydelta),
  1098.  (x, y, ylow, yhigh), (x, y, xdelta), (x, y, xlow, xhigh),
  1099.  (x, y, xdelta, ydelta), or (x, y, xlow, xhigh, ylow, yhigh).  The
  1100.  x co-ordinate must be specified. The order of the numbers must be
  1101.  exactly as given above, though the `using` qualifier can manipulate
  1102.  the order and provide values for missing columns.  For example,
  1103.  
  1104.    plot 'file' with errorbars
  1105.    plot 'file' using 1:2:(sqrt($1)) with xerrorbars
  1106.    plot 'file' using 1:2:($1-$3):($1+$3):4:5 with xyerrorbars
  1107.  
  1108.  The last plot is for a file with an unsupported combination of relative
  1109.  x and absolute y errors. The `using` spec generates absolute x min and
  1110.  max from the relative error.
  1111.  
  1112.  The y error bar is a vertical line plotted from (x, ylow) to (x, yhigh).
  1113.  If ydelta is specified instead of ylow and yhigh, ylow = y - ydelta and
  1114.  yhigh = y + ydelta are derived.  If there are only two numbers on the line,
  1115.  yhigh and ylow are both set to y.  The x error bar is a horizontal line
  1116.  computed in the same fashion.  To get lines plotted between the data points,
  1117.  `plot` the data file twice, once with errorbars and once with lines.
  1118.  
  1119.  The error bar has crossbars at top and bottom unless `set bar small` is used.
  1120.  
  1121.  If autoscaling is on, the ranges will be adjusted to fit the error bars.
  1122.  
  1123.  See `plot using`, `plot with`, and `set style` for more information.
  1124. ?plot parametric
  1125. ?splot parametric
  1126. ?parametric
  1127.  When in parametric mode (`set parametric`) mathematical expressions must be
  1128.  given in pairs for `plot` and in triplets for `splot`:
  1129.  
  1130.          plot sin(t),t**2
  1131.  or
  1132.          splot cos(u)*cos(v),cos(u)*sin(v),sin(u)
  1133.  
  1134.  Data files are plotted as before, except any preceding parametric function
  1135.  must be fully specified before a data file is given as a plot.  In other
  1136.  words, the x parametric function (`sin(t)` above) and the y parametric
  1137.  function (`t**2` above) must not be interrupted with any modifiers or data
  1138.  functions; doing so will generate a syntax error stating that the parametric
  1139.  function is not fully specified.
  1140.  
  1141.  Ranges take on a different meaning when in parametric mode.  The first range
  1142.  on the `plot` command is the `trange`, the next is the `xrange`, and the last
  1143.  is the `yrange`.  For `splot` the order is `urange`, `vrange`, `xrange`,
  1144.  `yrange`, and finally `zrange`.  The following `plot` command shows setting
  1145.  the `trange` to [-pi:pi], the `xrange` to [-1.3:1.3] and the `yrange` to
  1146.  [-1:1] for the duration of the plot:
  1147.  
  1148.          plot [-pi:pi] [-1.3:1.3] [-1:1] sin(t),t**2
  1149.  
  1150.  Other modifiers, such as `with` and `title`, may be specified only after the
  1151.  parametric function has been completed:
  1152.  
  1153.          plot sin(t),t**2 title 'Parametric example' with linespoints
  1154. ?splot ranges
  1155. ?plot ranges
  1156. ?ranges
  1157.  The optional ranges specify the region of the plot that will be displayed.
  1158.  
  1159.  Syntax:
  1160.          [{<dummy-var> =} {<xmin>} { : <xmax>}] { [{<ymin>} {: <ymax>}] }
  1161.  
  1162.  where <dummy-var> is the independent variable (the defaults are x and y,
  1163.  but these may be changed with `set dummy`) and the min and max terms can be
  1164.  constant expressions.
  1165.  
  1166.  * can be used to allow autoscaling of either of min and max.  See also
  1167.  `set autoscaling`
  1168.  
  1169.  Ranges specified on the `plot` or `splot` command line affect only that plot;
  1170.  use the `set xrange`, `set yrange`, etc., commands to change the default
  1171.  ranges for future plots.
  1172.  
  1173.  With time data, you must provide the range (in the same manner as the time
  1174.  appears in the datafile) within quotes.  `gnuplot` uses the `timefmt` string
  1175.  to read the value---see `set timefmt`.
  1176.  
  1177.  Examples:
  1178.  
  1179.  This uses the current ranges:
  1180.          plot cos(x)
  1181.  
  1182.  This sets the x range only:
  1183.          plot [-10:30] sin(pi*x)/(pi*x)
  1184.  
  1185.  This is the same, but uses t as the dummy-variable:
  1186.          plot [t = -10 :30]  sin(pi*t)/(pi*t)
  1187.  
  1188.  This sets both the x and y ranges:
  1189.          plot [-pi:pi] [-3:3]  tan(x), 1/x
  1190.  
  1191.  This sets only the y range, and turns off autoscaling on both axes:
  1192.          plot [ ] [-2:sin(5)*-8] sin(x)**besj0(x)
  1193.  
  1194.  This sets xmax and ymin only:
  1195.          plot [:200] [-pi:]  exp(sin(x))
  1196.  
  1197.  This sets the x, y, and z ranges:
  1198.          splot [0:3] [1:4] [-1:1] x*y
  1199.  
  1200.  This sets the x range for a timeseries (timefmt="%d/%m/%y %H:%M"):
  1201.          plot ["1/6/93 12:00":"5/6/93 12:00"] 'timedata.dat'
  1202. ?plot style
  1203. ?splot style
  1204. ?style
  1205. ?plot with
  1206. ?with
  1207.  Functions and data may be displayed in one of a large number of styles.
  1208.  The `with` keyword provides the means of selection.
  1209.  
  1210.  Syntax:
  1211.          with <style> {<linetype> {<pointtype>}}
  1212.  
  1213.  where <style> is either `lines`, `points`, `linespoints`, `impulses`, `dots`,
  1214.  `steps`, `fsteps`,  `errorbars`, `xerrorbars`, `yerrorbars`, `xyerrorbars`,
  1215.  `boxes`, `boxerrorbars`, `boxxyerrorbars`, `splines`, `csplines`, `bezier`,
  1216.  `sbezier`, or `vector`.  A given style may not be appropriate for both 2-D
  1217.  and 3-D plots and may require additional information.  See `set style
  1218.  <style>` for details about each style.
  1219.  
  1220.  Default styles are chosen with the `set function style` and `set data style`
  1221.  commands.
  1222.  
  1223.  By default, each function and data file will use a different line type and
  1224.  point type, up to the maximum number of available types.  All terminal
  1225.  drivers support at least six different point types, and re-use them, in
  1226.  order, if more than six are required.  The LaTeX driver supplies an
  1227.  additional six point types (all variants of a circle), and thus will only
  1228.  repeat after twelve curves are plotted with points.  The PostScript drivers
  1229.  (`postscript` and `enhpost`) supply a total of forty-eight.
  1230.  
  1231.  If you wish to choose the line or point type, <linetype> and <pointtype> may
  1232.  be specified.  These are positive integer constants (or expressions) that
  1233.  specify the line type and point type to be used for the plot.
  1234.  
  1235.  Use `test` to display the types available for your terminal.
  1236.  
  1237.  Examples:
  1238.  
  1239.  This plots sin(x) with impulses:
  1240.          plot sin(x) with impulses
  1241.  
  1242.  This plots x*y with points, x**2 + y**2 default:
  1243.          splot x*y w points, x**2 + y**2
  1244.  
  1245.  This plots tan(x) with the default function style, "data.1" with lines:
  1246.          plot [ ] [-2:5] tan(x), "data.1" with l
  1247.  
  1248.  This plots "leastsq.dat" with impulses:
  1249.          plot 'leastsq.dat' w i
  1250.  
  1251.  This plots the data file 'population' with boxes:
  1252.          plot "population" with boxes
  1253.  
  1254.  This plots "exper.dat" with errorbars and lines connecting the points:
  1255.          plot 'exper.dat' w lines, 'exper.dat' w errorbars
  1256.  
  1257.  Here 'exper.dat' should have three or four data columns.
  1258.  
  1259.  This plots x**2 + y**2 and x**2 - y**2 with the same line type:
  1260.          splot x**2 + y**2 with line 1, x**2 - y**2 with line 1
  1261.  
  1262.  This plots sin(x) and cos(x) with linespoints, using the
  1263.  same line type but different point types:
  1264.          plot sin(x) with linesp 1 3, cos(x) with linesp 1 4
  1265.  
  1266.  This plots file "data" with points style 3:
  1267.          plot "data" with points 1 3
  1268.  Note that the line style must be specified when specifying the point
  1269.  style, even when it is irrelevant. Here the line style is 1 and the
  1270.  point style is 3, and the line style is irrelevant.
  1271.  
  1272.  See `set style` to change the default styles.
  1273. ?plot title
  1274. ?splot title
  1275.  A title of each plot appears in the key.  By default the title is the
  1276.  function or file name as it appears on the plot command line.  The title
  1277.  can be changed by using the `title` option.  This option should precede
  1278.  any `with` option.
  1279.  
  1280.  Syntax:
  1281.          title "<title>" | notitle
  1282.  
  1283.  where <title> is the new title of the plot and must be enclosed in quotes.
  1284.  The quotes will not be shown in the key.  A special character may be given as
  1285.  a backslash followed by its octal value ("\345").  The tab character "\t" is
  1286.  understood.  Note that backslash processing occurs only for strings enclosed
  1287.  in double quotes---use single quotes to prevent such processing.
  1288.  
  1289.  Examples:
  1290.  
  1291.  This plots y=x with the title 'x':
  1292.          plot x
  1293.  
  1294.  This plots the "glass.dat" file with the title 'surface of revolution':
  1295.          splot "glass.dat" title 'surface of revolution'
  1296.  
  1297.  This plots x squared with title "x^2" and "data.1" with title 'measured
  1298.  data':
  1299.          plot x**2 title "x^2", "data.1" t 'measured data'
  1300.  
  1301.  The title can be omitted from the key by using the keyword `notitle`.  This
  1302.  can be useful when some curves are plotted solely for decoration.  For
  1303.  example, if one wanted a circular border for a polar plot, he could say:
  1304.  
  1305.  Example:
  1306.         set polar
  1307.         plot my_function(x), 1 notitle
  1308.  
  1309.  This would generate a key entry for "my_function" but not for "1".  See the
  1310.  poldat.dem example.  `title ''`  is equivalent to `notitle`.  `title ' '`
  1311.  can be used to have a sample with no text.
  1312. ?print
  1313.  The `print` command prints the value of <expression> to the screen.
  1314.  
  1315.  Syntax:
  1316.          print <expression>
  1317.  
  1318.  See `expressions`.
  1319. ?pwd
  1320.  The `pwd` command prints the name of the working directory to the screen.
  1321.  
  1322.  Syntax:
  1323.          pwd
  1324. ?quit
  1325.  The `exit` and `quit` commands and END-OF-FILE character will exit `gnuplot`.
  1326.  Each of these commands will clear the output device (as does the `clear`
  1327.  command) before exiting.
  1328. ?replot
  1329.  The `replot` command without arguments repeats the last `plot` or `splot`
  1330.  command.  This can be useful for viewing a plot with different `set`
  1331.  options, or when generating the same plot for several devices.
  1332.  
  1333.  Arguments specified after a `replot` command will be added onto the last
  1334.  `plot` or `splot` command (with an implied ',' separator) before it is
  1335.  repeated.  `replot` accepts the same arguments as the `plot` and `splot`
  1336.  commands except that ranges cannot be specified.  Thus you can use `replot`
  1337.  to plot a function against the second axes if the previous command was `plot`
  1338.  but not if it was `splot`, and similarly you can use `replot` to add a plot
  1339.  from a binary file only if the previous command was `splot`.
  1340.  
  1341.  N.B.---use of
  1342.  
  1343.    plot '-' ; ... ; replot
  1344.  
  1345.  is not recommended---`gnuplot` does not store the inline data internally.
  1346.  Since `replot` appends new information to the previous `plot` and then
  1347.  executes the modified command, the `'-'` will ask once more for the data.
  1348.  `'-'` is intended for situations where it is useful to have data and commands
  1349.  together, e.g., when `gnuplot` is run as a sub-process of some front-end
  1350.  application.  Some of the demos, for example, might use this feature.
  1351.  
  1352.  See `command-line-editing` for ways to edit the last `plot`
  1353.  (`splot`) command.
  1354. ?reread
  1355.  The `reread` command causes the current `gnuplot` command file, as specified
  1356.  by a `load` command or on the command line, to be reset to its starting
  1357.  point before further commands are read from it.  This essentially implements
  1358.  an endless loop of the commands from the beginning of the command file to
  1359.  the `reread` command.  The `reread` command has no effect if input from
  1360.  standard input.
  1361. ?reset
  1362.  The `reset` command causes all options that can be set with the `set`
  1363.  command to take on their default values.  The only exceptions are that the
  1364.  terminal set with `set term` and the output file set with `set output` are
  1365.  left unchanged.  This command is useful, e.g., to restore the default
  1366.  settings at the end of a command file, or to return to a defined state after
  1367.  lots of settings have been changed within a command file.  Please refer to
  1368.  the `set` command to see the default values that the various options take.
  1369. ?save
  1370.  The `save` command saves user-defined functions, variables, `set` options,
  1371.  or all three, plus the last `plot` (`splot`) command to the specified file.
  1372.  
  1373.  Syntax:
  1374.          save  {<option>} "<filename>"
  1375.  
  1376.  where <option> is `functions`, `variables` or `set`. If no option is used,
  1377.  `gnuplot` saves functions, variables, `set` options and the last `plot`
  1378.  (`splot`) command.
  1379.  
  1380.  `save`d files are written in text format and may be read by the `load`
  1381.  command.
  1382.  
  1383.  The filename must be enclosed in quotes.
  1384.  
  1385.  Examples:
  1386.  
  1387.          save "work.gnu"
  1388.          save functions 'func.dat'
  1389.          save var 'var.dat'
  1390.          save set "options.dat"
  1391. ?set
  1392. ?show
  1393. ?show all
  1394.  The `set` command sets LOTS of options.
  1395.  
  1396.  The `show` command shows their settings.  `show all` shows all the
  1397.  settings.
  1398. ?set angles
  1399. ?show angles
  1400. ?angles
  1401. ?set angles degrees
  1402.  By default, `gnuplot` assumes the independent variable in polar plots is in
  1403.  units of radians.  If `set angles degrees` is specified before `set polar`,
  1404.  then the default range is [0:360] and the independent variable has units of
  1405.  degrees.  This is particularly useful for plots of data files.  The angle
  1406.  setting also applies to 3-d mapping as set via the `set mapping` command.
  1407.  
  1408.  Syntax:
  1409.          set angles { degrees | radians }
  1410.          show angles
  1411.  
  1412.  The angle specified in `set grid polar` is also read and displayed in the
  1413.  units specified by `set angles`.
  1414.  
  1415.  `set angles` has no effect on the arguments of machine-defined functions
  1416.  (sin(x), cosh(x), besj0(x), etc.); neither does it affect the result of
  1417.  inverse trigonometric functions, e.g. atan(x).  These are always given in
  1418.  radians.
  1419. ?set arrow
  1420. ?set noarrow
  1421. ?show arrow
  1422. ?arrow
  1423. ?noarrow
  1424.  Arbitrary arrows can be placed on a plot using the `set arrow` command.
  1425.  
  1426.  Syntax:
  1427.           set arrow {<tag>} {from <position>} \
  1428.                             {to <position>} {{no}head} \
  1429.                             {<linestyle>}
  1430.           set noarrow {<tag>}
  1431.           show arrow
  1432.  
  1433.  
  1434.  Unspecified co-ordinates default to 0.  The endpoints can be specified in
  1435.  one of four co-ordinate systems---`first` or `second` axes, `graph` or
  1436.  `screen`.  See `set co-ordinates` for details.  Arrows outside the screen
  1437.  boundaries are permitted but may cause device errors.
  1438.  
  1439.  <tag> is an integer that identifies the arrow.  If no tag is given, the
  1440.  lowest unused tag value is assigned automatically.  The tag can be used to
  1441.  delete or change a specific arrow.  To change any attribute of an existing
  1442.  arrow, use the `set arrow` command with the appropriate tag and specify the
  1443.  parts of the arrow to be changed.
  1444.  
  1445.  Specifying `nohead` produces an arrow drawn without a head---a line segment.
  1446.  This gives you yet another way to draw a line segment on the graph.  By
  1447.  default, arrows have heads.
  1448.  
  1449.  `linestyle` allows specification of the line style to be used for the arrow.
  1450.  
  1451.  Examples:
  1452.  
  1453.  To set an arrow pointing from the origin to (1,2), use:
  1454.           set arrow to 1,2
  1455.  To set an arrow from bottom left of plotting area to (-5,5,3), and tag the
  1456.  arrow number 3, use:
  1457.           set arrow 3 from graph 0,0 to -5,5,3
  1458.  To change the preceding arrow to end at 1,1,1, without an arrow head, use:
  1459.           set arrow 3 to 1,1,1 nohead
  1460.  To draw a vertical line from the bottom to the top of the graph at x=3, use:
  1461.           set arrow from 3, graph 0 to 3, graph 1 nohead
  1462.  To delete arrow number 2 use:
  1463.           set noarrow 2
  1464.  To delete all arrows use:
  1465.           set noarrow
  1466.  To show all arrows (in tag order) use:
  1467.           show arrow
  1468. ?set autoscale
  1469. ?set noautoscale
  1470. ?show autoscale
  1471. ?autoscale
  1472. ?noautoscale
  1473.  Autoscaling may be set individually on the x, y or z axis or globally on all
  1474.  axes. The default is to autoscale all axes.
  1475.  
  1476.  Syntax:
  1477.          set autoscale <axes>{min|max}
  1478.          set noautoscale <axes>{min|max}
  1479.          show autoscale
  1480.  
  1481.  where <axes> is either `x`, `y`, `z`, `x2`, `y2` or `xy`.  A keyword with
  1482.  `min` or `max` appended (this cannot be done with `xy`) tells `gnuplot` to
  1483.  autoscale just the minimum or maximum of that axis.  If no keyword is given,
  1484.  all axes are autoscaled.
  1485.  
  1486.  When autoscaling, the plot range is automatically computed and the dependent
  1487.  axis (y for a `plot` and z for `splot`) is scaled to include the range of the
  1488.  function or data being plotted.
  1489.  
  1490.  If autoscaling of the dependent axis (y or z) is not set, the current y or z
  1491.  range is used.
  1492.  
  1493.  See `set yrange` or `set zrange`.
  1494.  
  1495.  Autoscaling the independent variables (x for `plot` and x,y for `splot`) is a
  1496.  request to set the domain to match any data file being plotted.  If there are
  1497.  no data files, autoscaling an independent variable has no effect.  In other
  1498.  words, in the absence of a data file, functions alone do not affect the x
  1499.  range (or the y range if plotting z = f(x,y)).
  1500.  
  1501.  See `set xrange` or `set yrange`.
  1502.  
  1503.  The behavior of autoscaling remains consistent in parametric mode, (see `set
  1504.  parametric`).  However, there are more dependent variables and hence more
  1505.  control over x, y, and z plot scales.  In parametric mode, the independent
  1506.  or dummy variable is t for `plot`s and u,v for `splot`s.  `autoscale` in
  1507.  parametric mode, then, controls all ranges (t, u, v, x, y, and z) and allows
  1508.  x, y, and z to be fully autoscaled.
  1509.  
  1510.  When tics are displayed on second axes but no plot has been specified for
  1511.  those axes, x2range and y2range are inherited from xrange and yrange.  This
  1512.  is done _before_ xrange and yrange are autoextended to a whole number of
  1513.  tics, which can cause unexpected results.
  1514.  
  1515.  Examples:
  1516.  
  1517.  This sets autoscaling of the y axis (other axes are not affected):
  1518.          set autoscale y
  1519.  
  1520.  This sets autoscaling only for the minimum of the y axis (the maximum of the
  1521.  y axis and the other axes are not affected):
  1522.          set autoscale ymin
  1523.  
  1524.  This sets autoscaling of the x and y axes:
  1525.          set autoscale xy
  1526.  
  1527.  This sets autoscaling of the x, y, z, x2 and y2 axes:
  1528.          set autoscale
  1529.  
  1530.  This disables autoscaling of the x, y, z, x2 and y2 axes:
  1531.          set noautoscale
  1532.  
  1533.  This disables autoscaling of the z axis only:
  1534.          set noautoscale z
  1535. ?autoscale parametric
  1536. ?set autoscale t
  1537.  When in parametric mode (`set parametric`), the  xrange is as fully scalable
  1538.  as the y range.  In other words, in parametric mode the x axis can be
  1539.  automatically scaled to fit the range of the parametric function that is
  1540.  being plotted.  Of course, the y axis can also be automatically scaled just
  1541.  as in the non-parametric case.  If autoscaling on the x axis is not set, the
  1542.  current x range is used.
  1543.  
  1544.  Data files are plotted the same in parametric and nonparametric mode.
  1545.  However, there is a difference in mixed function and data plots: in
  1546.  non-parametric mode with autoscaled x, the x range of the datafile controls
  1547.  the x range of the functions; in parametric mode it has no influence.
  1548.  
  1549.  For completeness a last command `set autoscale t` is accepted.  However, the
  1550.  effect of this "scaling" is very minor.  When `gnuplot` determines that the
  1551.  t range would be empty, it makes a small adjustment if autoscaling is true.
  1552.  Otherwise, `gnuplot` gives an error.  Such behavior may, in fact, not be very
  1553.  useful and the command `set autoscale t` is certainly questionable.
  1554.  
  1555.  `splot` extends the above ideas as you would expect.  If autoscaling is set,
  1556.  then x, y, and z ranges are computed and each axis scaled to fit the
  1557.  resulting data.
  1558. ?set bar
  1559. ?show bar
  1560.  The `set bar` command controls the tics at the ends of errorbars.
  1561.  
  1562.  Syntax:
  1563.          set bar {small | large | <size>}
  1564.          show bar
  1565.  
  1566.  `small` is a synonym for 0.0, and `large` for 1.0.
  1567.  The default is 1.0 if no size is given.
  1568.  The command `set bmargin` sets the size of the bottom margin.  Please see
  1569.  `set margins` for details.
  1570. ?set border
  1571. ?set noborder
  1572. ?show border
  1573. ?border
  1574. ?noborder
  1575.  The `set border` and `set noborder` commands control the display of the plot
  1576.  borders for the `plot` and `splot` commands.  The borders are encoded in a
  1577.  twelve-bit integer: the bottom 4 bits control the border for `plot` and the
  1578.  sides of the base for `splot`.  The next 4 bits control the verticals in
  1579.  `splot`, while the top 4 bits control the edges on top of the `splot`.  The
  1580.  default is 31, which is all four sides for `plot`, and base and z axis for
  1581.  `splot`.
  1582.  
  1583.  Syntax:
  1584.          set border    (turns on all borders)
  1585.          set border 3  (only SOUTHWEST borders)
  1586.          set border 4095   (complete box around splot)
  1587.          set border 127+256+512  (partial box omitting front vertical)
  1588.          set noborder
  1589.          show border
  1590.  
  1591.  To have tics on edges other than bottom and left, disable the usual
  1592.  tics and enable the second axes.
  1593.  
  1594.          set border 12 (only NORTHEAST borders)
  1595.          set noxtics; set noytics; set x2tics; set y2tics
  1596. ?set boxwidth
  1597. ?show boxwidth
  1598. ?boxwidth
  1599.  The `set boxwidth` command is used to set the default width of boxes in the
  1600.  `boxes` and `boxerrorbars` styles.
  1601.  
  1602.  Syntax:
  1603.           set boxwidth {<width>}
  1604.           show boxwidth
  1605.  
  1606.  If a data file is plotted without the width being specified in the third,
  1607.  fourth, or fifth column, or if a function is plotted, the width of each box
  1608.  is set by the `set boxwidth` command.  (If a width is given after the `set
  1609.  boxwidth` command, the one taken from the data is used.)  If the width is
  1610.  not specified in one of these ways, the width of each box will be calculated
  1611.  automatically so that it touches the adjacent boxes.  In a four-column data
  1612.  set, the fourth column will be interpreted as the box width unless the width
  1613.  is set to -2.0, in which case the width will be calculated automatically.
  1614.  See `boxerrorbars` or `set style` for more details.
  1615.  
  1616.  To set the box width to automatic use the command
  1617.           set boxwidth
  1618.           set boxwidth -2  (4-col data)
  1619.  
  1620.  The same effect can be achieved with the `using` keyword in `plot`:
  1621.           plot 'file' using 1:2:3:4:(-2)
  1622. ?set clabel
  1623. ?set noclabel
  1624. ?show clabel
  1625. ?clabel
  1626. ?noclabel
  1627.  `gnuplot` will vary the linetype used for each contour level when clabel is
  1628.  set.  When this option on (the default), a legend labels each linestyle with
  1629.  the z level it represents.  It is not possible at present to separate the
  1630.  contour labels from the surface key.
  1631.  
  1632.  Syntax:
  1633.          set clabel
  1634.          set noclabel
  1635.          show clabel
  1636.  
  1637.  See also `set contour`.
  1638. ?set clip
  1639. ?set noclip
  1640. ?show clip
  1641. ?clip
  1642. ?noclip
  1643.  `gnuplot` can clip data points and lines that are near the boundaries of a
  1644.  plot.
  1645.  
  1646.  Syntax:
  1647.          set clip <clip-type>
  1648.          set noclip <clip-type>
  1649.          show clip
  1650.  
  1651.  Three clip types are supported by `gnuplot`: `points`, `one`, and `two`.
  1652.  One, two, or all three clip types may be active for a single plot.
  1653.  
  1654.  The `points` clip type forces `gnuplot` to clip (actually, not plot at all)
  1655.  data points that fall within but too close to the boundaries.  This is done
  1656.  so that large symbols used for points will not extend outside the boundary
  1657.  lines.  Without clipping points near the boundaries, the plot may look bad.
  1658.  Adjusting the x and y ranges may give similar results.
  1659.  
  1660.  Setting the `one` clip type causes `gnuplot` to plot a line segment which has
  1661.  only one of its two endpoints within the plotting region.  Only the in-range
  1662.  portion of the line is drawn.  The alternative is to not draw any portion of
  1663.  the line segment.
  1664.  
  1665.  Some lines may have both endpoints out of range, but pass through the
  1666.  plotting area.  Setting the `two` clip-type allows the visible portion of
  1667.  these lines to be drawn.
  1668.  
  1669.  In no case is a line drawn outside the plotting area.
  1670.  
  1671.  The defaults are `noclip points`, `clip one`, and `noclip two`.
  1672.  
  1673.  To check the state of all forms of clipping, use
  1674.          show clip
  1675.  
  1676.  For backward compatibility with older versions, the following forms are also
  1677.  permitted:
  1678.         set clip
  1679.         set noclip
  1680.  `set clip` is synonymous with `set clip points`; `set noclip` turns off all
  1681.  three types of clipping.
  1682. ?set cntrparam
  1683. ?show cntrparam
  1684. ?cntrparam
  1685.  `set cntrparam` controls the generation of contours and their smoothness for
  1686.  a contour plot.
  1687.  
  1688.  Syntax:
  1689.          set cntrparam { { linear | cubicspline | bspline } |
  1690.               points <n> |
  1691.               order <n> |
  1692.               levels { [ auto ] <n> |
  1693.                        discrete <z1>,<z2>, ... |
  1694.                        incremental {<start>, <incr>{, <end>} } } }
  1695.          show cntrparam
  1696.  
  1697.  This command controls the way contours are plotted.  <n> should be an
  1698.  integral constant expression and <z1>, <z2> any constant expressions.
  1699.  The parameters are:
  1700.  
  1701.  `linear`, `cubicspline`, `bspline`---Controls type of approximation or
  1702.  interpolation.  If `linear`, then the contours are drawn piecewise linear, as
  1703.  extracted from the surface directly.  If `cubicspline`, then piecewise linear
  1704.  contours are interpolated to form somewhat smoother contours, but which may
  1705.  undulate.  If `bspline`, a guaranteed-smoother curve is drawn, which only
  1706.  approximates the piecewise linear data.
  1707.  
  1708.  `points`---Eventually all drawings are done with piecewise linear strokes.
  1709.  This number controls the number of points used to approximate a curve.
  1710.  It is relevant only for `cubicspline` and `bspline` modes.
  1711.  
  1712.  `order`---Order of the bspline approximation to be used.  The bigger this
  1713.  order is, the smoother the resulting contour.  (Of course, higher order
  1714.  bspline curves will move further away from the original piecewise linear
  1715.  data.)  This option is relevant for `bspline` mode only.  Allowed values are
  1716.  integers in the range from 2 (linear) to 10.
  1717.  
  1718.  `levels`---Number of contour levels.  Selection of the levels is controlled
  1719.  by `auto` (default), `discrete`, and `incremental`.  For `auto`, if the
  1720.  surface is bounded by zmin and zmax, contours will be generated from zmin+dz
  1721.  to zmax-dz in steps of size dz, where dz = (zmax - zmin) / (levels + 1).  For
  1722.  `discrete`, contours will be generated at z = z1, z2 ... as specified.  The
  1723.  number of discrete levels is limited to MAX_DISCRETE_LEVELS, defined in
  1724.  plot.h to be 30.  If `incremental`, contours are generated at values of z
  1725.  beginning at <start> and increasing by <increment> until <end> is reached.
  1726.  If <end> is not specified, MAX_DISCRETE_LEVELS will be generated.
  1727.  
  1728.  Examples:
  1729.      set cntrparam bspline
  1730.      set cntrparam points 7
  1731.      set cntrparam order 10
  1732.      set cntrparam levels auto 5                   # 5 automatic levels
  1733.      set cntrparam levels discrete .1,1/exp(1),.9  # 3 discrete at .1,.37,.9
  1734.      set cntrparam levels incremental  0,.1,.4
  1735.      # 5 incremental levels at 0, .1, .2, .3 and .4
  1736.      set cntrparam levels 10
  1737.      # sets n = 10 retaining current setting of auto, discr. and
  1738.      # increment's start and increment value, while changing end
  1739.      set cntrparam levels incremental 100,50
  1740.      # set start = 100 and increment = 50, retaining n levels
  1741.  
  1742.  See also `set contour`.
  1743. ?set contour
  1744. ?show contour
  1745. ?contour
  1746.  `set contour` enables contour drawing for surfaces. This option is available
  1747.  for `splot` only.
  1748.  
  1749.  Syntax:
  1750.          set contour { base | surface | both }
  1751.          set nocontour
  1752.  
  1753.  The three options specify where to draw the contours: `base` draws the
  1754.  contours on the grid base where the x/ytics are placed, `surface` draws the
  1755.  contours on the surfaces themselves, and `both` draws the contours on both
  1756.  the base and the surface.  If no option is provided, the default is `base`.
  1757.  
  1758.  See also `set cntrparam` for the parameters that affect the drawing of
  1759.  contours, and `set clabel` for control of labelling of the contours.
  1760.  
  1761.  The surface can be switched off (see `set surface`), giving a contour-only
  1762.  plot.  Though it is possible to set the view to give a full-page plot, good
  1763.  results can be obtained by writing the contour information out to a file, and
  1764.  rereading it as a 2-d datafile plot:
  1765.  
  1766.    set nosurface
  1767.    set contour
  1768.    set cntrparam ...
  1769.    set term table
  1770.    set out 'filename'
  1771.    splot ...
  1772.    set out
  1773.    # contour info now in filename
  1774.    set term <whatever>
  1775.    plot 'filename'
  1776.  
  1777.  In order to draw contours, the data must be organized as "grid data".  In
  1778.  such a file all of the points for a single y value are listed, then all the
  1779.  points for the next y, and so on.  A single null line (a line containing no
  1780.  characters other than a carriage return and/or a line feed) separates one y
  1781.  value group from the next.  See also `plot datafile`.
  1782.  
  1783.  If contours are desired from non-grid data, `set dgrid3d` can be used to
  1784.  create an appropriate grid.  See `set dgrid3d` for more information.
  1785. ?co-ordinates
  1786.  While there is no `set co-ordinates` command, the commands `set arrow`, `set
  1787.  key`, and `set label` allow you to draw something at an arbitrary position
  1788.  on the graph.  This position is specified by the syntax:
  1789.  
  1790.           {first | second | graph | screen} x,\
  1791.           {first | second | graph | screen} y\
  1792.           {, {first | second | graph | screen} z}
  1793.  
  1794.  `first` places the x, y, or z co-ordinate in the system defined by the left
  1795.  and bottom axes; `second` places it in the system defined by the second axes
  1796.  (top and right); `graph` specifies the area within the axes---0,0 is bottom
  1797.  left and 1,1 is top right (for splot, 0,0,0 is bottom left of plotting area;
  1798.  use negative z to get to the base---see `set ticslevel`); and `screen`
  1799.  specifies the screen area---0,0 is bottom left and 1,1 is top right.
  1800.  
  1801.  If the co-ordinate system is not specified, `first` is used.
  1802.  
  1803.  If one (or more) axis is timeseries, the appropriate co-ordinate should
  1804.  be given as a quoted time string according to the `timefmt` format string.
  1805.  See `set {x,y,z}data` and `set timefmt`.
  1806. ?set data style
  1807. ?show data style
  1808. ?data style
  1809.  The `set data style` command changes the default plotting style for data
  1810.  plots.
  1811.  
  1812.  Syntax:
  1813.          set data style <style-choice>
  1814.          show data style
  1815.  
  1816.  See `set style` for the choices.  If no choice is given, the choices are
  1817.  listed.  `show data style` shows the current default data plotting style.
  1818. ?set dgrid3d
  1819. ?set nodgrid3d
  1820. ?show dgrid3d
  1821. ?dgrid3d
  1822.  The `set dgrid3d` command enables and sets the different parameters for
  1823.  non-grid to grid data mapping.
  1824.  
  1825.  Syntax:
  1826.          set dgrid3d {,{<row_size>}{,{<col_size>}{,<norm>}}}
  1827.          set nodgrid3d
  1828.          show dgrid3d
  1829.  
  1830.  By default `dgrid3d` is disabled.  When enabled, 3-d data read from a file
  1831.  are always treated as a scattered data set.  A grid with dimensions derived
  1832.  from a bounding box of the scattered data and size as specified by the
  1833.  row/col_size parameters is created for plotting and contouring.  The grid is
  1834.  equally spaced in x and y; the z values are computed as weighted averages of
  1835.  the scattered points' values.
  1836.  
  1837.  The third parameter, norm, controls the weighting: each point is weighted
  1838.  inversely by its distance (from the grid point) raised to the norm power.
  1839.  (Actually it's not quite the distance: the weights are given by the inverse
  1840.  of dx^norm + dy^norm, where dx and dy are the components of the separation
  1841.  of the grid point from each data point.)  Thus the closer the data point is
  1842.  to a grid point, the more effect it has on that grid point.  In `gnuplot`,
  1843.  this distance computation is optimized for norms that are powers of 2,
  1844.  specifically 1, 2, 4, 8, and 16, but any non-negative integer can be used.
  1845.  
  1846.  The `dgrid3d` option is a simple low pass filter that converts scattered data
  1847.  to a grid data set.  More sophisticated approaches to this problem exist and
  1848.  should be used to preprocess the data outside `gnuplot` if this simple
  1849.  solution is found inadequate.
  1850.  
  1851.  Examples:
  1852.         set dgrid3d 10,10,2
  1853.         set dgrid3d ,,4
  1854.  
  1855.  The first specifies that a grid of size 10 by 10 is to be constructed using
  1856.  the L2 norm (a norm of 2 is to be used in the distance computation).  The
  1857.  second only modifies the norm to be used to L4.
  1858.  
  1859. ?set dummy
  1860. ?show dummy
  1861. ?dummy
  1862.  The `set dummy` command changes the default dummy variable names.
  1863.  
  1864.  Syntax:
  1865.          set dummy <dummy-var>{,<dummy-var>}
  1866.          show dummy
  1867.  
  1868.  By default, `gnuplot` assumes that the independent variable for the `plot`
  1869.  command is x, and the independent variables for the `splot` command are x and
  1870.  y.  They are called the dummy variables because it is just a notation to
  1871.  indicate the independent variables.  It may be more convenient to call a
  1872.  dummy variable by a more physically meaningful or conventional name.  For
  1873.  example, when plotting time functions:
  1874.  
  1875.          set dummy t
  1876.          plot sin(t), cos(t)
  1877.  
  1878.  Examples:
  1879.          set dummy u,v
  1880.          set dummy ,s
  1881.  
  1882.  The second example sets the second variable to s.
  1883.  
  1884.  The `set parametric` command also changes the dummy variables (to t for
  1885.  `plot` and u,v for `splot`).
  1886. ?set format
  1887. ?show format
  1888. ?format
  1889.  The format of the tic-mark labels can be set with the `set format` command.
  1890.  
  1891.  Syntax:
  1892.          set format {<axes>} {"<format-string>"}
  1893.          set format {<axes>} {'<format-string>'}
  1894.          show format
  1895.  
  1896.  where <axes> is either `x`, `y`, `z`, `xy`, `x2`, `y2` or nothing (which is
  1897.  the same as `xy`).  The length of the string representing a ticmark (after
  1898.  formatting with printf) is restricted to 100 characters.  If the format
  1899.  string is omitted, the format will be returned to the default "%g".  For
  1900.  LaTeX users, the format "$%g$" is often desirable.  If the empty string "" is
  1901.  used, no label will be plotted with each tic, though the tic mark will still
  1902.  be plotted.  To eliminate all tic marks, use `set noxtics` or `set noytics`.
  1903.  
  1904.  The default format for both axes is "%g", but other formats such as "%.2f" or
  1905.  "%3.0fm" are often desirable.  Anything accepted by printf when given a
  1906.  double precision number, and then accepted by the terminal, will work.  In
  1907.  particular, the formats f, e, and g will work, and the d, o, x, c, s, and u
  1908.  formats will not work.  If the data type for the axis is date/time, the
  1909.  format string must contain valid codes for the strftime function (outside of
  1910.  `gnuplot`, type `man strftime`).  It is best to stick to the conversion codes
  1911.  accepted by the `set timefmt` command.  If the format string looks like a
  1912.  floating point format, then `gnuplot` tries to construct a reasonable format.
  1913.  
  1914.  For `plot`, newline (\n) is accepted in the x-axis format string; for
  1915.  `splot`, newline is allowed for both x- and y-axis format strings.  Use
  1916.  double-quotes rather than single-quotes to enable such interpretation.  See
  1917.  also `syntax`.
  1918.  
  1919.  See also `set xtics` and `set ytics` for more control over tic labels.
  1920. ?set function style
  1921. ?show function style
  1922. ?function style
  1923.  The `set function style` command changes the default plotting style for
  1924.  function plots.
  1925.  
  1926.  Syntax:
  1927.          set function style <style-choice>
  1928.          show function style
  1929.  
  1930.  See `set style` for the choices.  If no choice is given, the choices are
  1931.  listed.  `show function style` shows the current default function plotting
  1932.  style.
  1933. ?show functions
  1934.  The `show functions` command lists all user-defined functions and their
  1935.  definitions.
  1936.  
  1937.  Syntax:
  1938.          show functions
  1939. ?set grid
  1940. ?show grid
  1941. ?grid
  1942.  The `set grid` command allows grid lines to be drawn on the graph.
  1943.  
  1944.  Syntax:
  1945.          set grid {{no}{m}xtics} {{no}{m}ytics} {{no}{m}ztics} \
  1946.               {{no}{m}x2tics} {{no}{m}y2tics} \
  1947.               {polar {<angle>} {<major-linetype> {<minor-linetype>}}}
  1948.          show grid
  1949.  
  1950.  The grid can be enabled and disabled for the major and/or minor tic marks on
  1951.  any axis, and the linetype can be specified for major and minor grid lines.
  1952.  Additionally, a polar grid can be selected for 2-d plots---circles are drawn
  1953.  to intersect the selected tics, and radial lines are drawn at definable
  1954.  intervals.  (The interval is given in degrees or radians ,depending on the
  1955.  `set angles` setting.)  Note that a polar grid is no longer automatically
  1956.  generated in polar mode.
  1957.  
  1958.  The pertinent tics must be enabled before `set grid` can draw them; `gnuplot`
  1959.  will quietly ignore instructions to draw grid lines at non-existent tics, but
  1960.  they will appear if the tics are subsequently enabled.
  1961.  
  1962.  If no linetype is specified for the minor gridlines, the same linetype as the
  1963.  major gridlines is used.  The default polar angle is 30 degrees.
  1964.  
  1965.  Z grid lines are drawn on the back of the plot.  This looks better if a
  1966.  partial box is drawn around the plot---see `set border`.
  1967. ?set hidden3d
  1968. ?show hidden3d
  1969.  The `set hidden3d` command enables hidden line removal for explicit surface
  1970.  plotting (see `splot`).
  1971.  
  1972.  Syntax:
  1973.          set hidden3d
  1974.          set nohidden3d
  1975.          show hidden3d
  1976.  
  1977.  Hidden line removal may be used for both explicit functions and for explicit
  1978.  data.  It now works for parametric surfaces as well.  This mode is meaningful
  1979.  only when surfaces are `splot`ted `with lines`.
  1980.  
  1981.  When this flag is set, both the hidden portion of the surface and possibly
  1982.  its hidden contours (see `set contour`) as well as the hidden grid will be
  1983.  removed.  Each surface has its hidden parts removed with respect to itself
  1984.  and to other surfaces, if more than one surface is plotted.  But contours
  1985.  drawn on the surface (`set contour surface`) don't seem to work.  Labels and
  1986.  arrows are always visible and are unaffected.
  1987. ?set isosamples
  1988. ?show isosamples
  1989. ?isosamples
  1990.  The isoline density of surfaces may be changed by the `set isosamples`
  1991.  command.
  1992.  
  1993.  Syntax:
  1994.          set isosamples <iso_1> {,<iso_2>}
  1995.          show isosamples
  1996.  
  1997.  Each surface plot will have <iso_1> iso-u lines and <iso_2> iso-v lines.  If
  1998.  you only specify <iso_1>, <iso_2> will be set to the same value as <iso_1>.
  1999.  By default, sampling is set to 10 isolines per u or v axis.  A higher
  2000.  sampling rate will produce more accurate plots, but will take longer.  These
  2001.  parameters have no effect on data file plotting.
  2002.  
  2003.  An isoline is a curve parameterized by one of the surface parameters while
  2004.  the other surface parameter is fixed.  Isolines provide a simple means to
  2005.  display a surface.  By fixing the u parameter of surface s(u,v), the iso-u
  2006.  lines of the form c(v) = s(u0,v) are produced, and by fixing the v parameter,
  2007.  the iso-v lines of the form c(u) = s(u,v0) are produced.
  2008.  
  2009.  When a surface plot is being done without the removal of hidden lines, `set
  2010.  samples` also has an effect on the number of points being evaluated---it
  2011.  controls the number of points sampled along each isoline.  See `set samples`.
  2012. ?set key
  2013. ?set nokey
  2014. ?show key
  2015. ?key
  2016.  The `set key` enables a key describing curves on a plot.
  2017.  
  2018.  Syntax:
  2019.          set key { <position> | \
  2020.                   left | right | top | bottom | outside | below } \
  2021.                  { Left | Right } \
  2022.                  { {no}reverse } \
  2023.                  { title "<text>" } \
  2024.                  { {no}box {<linetype>} }
  2025.          set nokey
  2026.          show key
  2027.  
  2028.  By default the key is placed in the upper right corner of the plot.  The
  2029.  keywords `left`, `right`, `top`, `bottom`, `outside` and `below` may be used
  2030.  to place the key in the other corners inside the plot or to the right
  2031.  (outside) or below the plot.  They may be given alone or combined.
  2032.  
  2033.  Justification of the labels within the key is controlled by `Left` or `Right`
  2034.  (default is `Right`).  The text and sample can be reversed (`reverse`) and a
  2035.  box can be drawn around the key (`box {<linetype>}`) in a specified linetype.
  2036.  A title can be put on the key (`title "<text>"`)---see also `syntax` for the
  2037.  distinction between text in single- or double-quotes.  The title may also be
  2038.  specified by `set keytitle`.  The title uses the same justification as do the
  2039.  individual labels.
  2040.  
  2041.  The <position> can be a simple x,y,z as in previous versions, but these can
  2042.  be preceded by one of four keywords (`first`, `second`, `graph`, `screen`)
  2043.  which selects the co-ordinate system in which the position is specified.  See
  2044.  `set co-ordinates` for more details.  The key is drawn as a sequence of
  2045.  lines, with one plot described on each line.  On the right-hand side (or the
  2046.  left-hand side, if `reverse` is selected) of each line is a representation
  2047.  that attempts to mimic the way the curve is plotted.  On the other side of
  2048.  each line is the text description, obtained from the `plot` command.  See
  2049.  `plot title` to change this description.  The lines are vertically arranged
  2050.  so that an imaginary straight line divides the left- and right-hand sides of
  2051.  the key.  It is the co-ordinates of this line that are specified with the
  2052.  `set key` command.  In a `plot`, only the x and y co-ordinates are used to
  2053.  specify the line position.  For a `splot`, x, y and z are all used as a 3-d
  2054.  location mapped using the same mapping as the plot itself to form the
  2055.  required 2-d screen position of the imaginary line.
  2056.  
  2057.  Some or all of the key may be outside of the plot boundary, although this may
  2058.  interfere with other labels and may cause an error on some devices.  If you
  2059.  use the keywords `outside` or `below`, `gnuplot` makes space for the keys and
  2060.  the plot becomes smaller.  Putting keys outside to the right, they occupy as
  2061.  few columns as possible, and putting them below, as many columns as possible
  2062.  (depending of the length of the labels), thus stealing as little space from
  2063.  the plot as possible.
  2064.  
  2065.  When using the TeX or enhpost drivers, or similar drivers where formatting
  2066.  information is embedded in the string, `gnuplot` is unable to calculate
  2067.  correctly the width of the string for key positioning.  If the key is to be
  2068.  positioned at the left, it may be convenient to use the combination  `set key
  2069.  left Left reverse`.  The box and gap in the grid will be the width of the
  2070.  literal string.
  2071.  
  2072.  Examples:
  2073.  
  2074.  This places the key at the default location:
  2075.          set key
  2076.  This disables the key:
  2077.          set nokey
  2078.  This places a key at co-ordinates 2,3.5,2:
  2079.          set key 2,3.5,2
  2080.  This places the key below the plot:
  2081.          set key below
  2082.  This places the key in the bottom left corner, left-justifies the text,
  2083.  gives it a title, and draws a box around it in linetype 3:
  2084.          set key left bottom Left title 'Legend' box 3
  2085. ?set keytitle
  2086. ?show keytitle
  2087.  This command allows a key header to the printed above the keys.
  2088.  
  2089.  Syntax:
  2090.          set keytitle "<string>"
  2091.          show keytitle
  2092.  
  2093.  The key title may also be specified directly on the `set key` command.  See
  2094.  `set key` for details.  See also ` set syntax` for the distinction between
  2095.  enclosing the string in single- or double-quotes.
  2096. ?set label
  2097. ?set nolabel
  2098. ?show label
  2099. ?label
  2100. ?nolabel
  2101.  Arbitrary labels can be placed on the plot using the `set label` command.
  2102.  
  2103.  Syntax:
  2104.           set label {<tag>} {"<label_text>"} {at <position>}
  2105.                             {<justification>} {font "<name><,size>"}
  2106.           set nolabel {<tag>}
  2107.           show label
  2108.  
  2109.  The <position> is specified by either x,y or x,y,z, and may be preceded by
  2110.  `first`, `second`, `graph`, or `screen` to select the co-ordinate system.
  2111.  See `set co-ordinates` for details.
  2112.  
  2113.  The text is scanned for backslash-octal (\nnn) conversion.  It defaults to
  2114.  the null text "".
  2115.  
  2116.  The tag is an integer that is used to identify the label. If no <tag> is
  2117.  given, the lowest unused tag value is assigned automatically.  The tag can be
  2118.  used to delete or modify a specific label.  To change any attribute of an
  2119.  existing label, use the `set label` command with the appropriate tag, and
  2120.  specify the parts of the label to be changed.
  2121.  
  2122.  By default, the text is placed flush left against the point x,y,z.  To adjust
  2123.  the way the label is positioned with respect to the point x,y,z, add the
  2124.  parameter <justification>, which may be `left`, `right` or `center`,
  2125.  indicating that the point is to be at the left, right or center of the text.
  2126.  Labels outside the plotted boundaries are permitted but may interfere with
  2127.  axis labels or other text.
  2128.  
  2129.  If one (or more) axis is timeseries, the appropriate co-ordinate should be
  2130.  given as a quoted time string according to the `timefmt` format string.  See
  2131.  `set {x,y,z}data` and `set timefmt`.
  2132.  
  2133.  The EEPIC, Imagen, LaTeX, and TPIC drivers allow \\ in a string to specify
  2134.  a newline.
  2135.  
  2136.  Examples:
  2137.  
  2138.  To set a label at (1,2) to "y=x", use:
  2139.           set label "y=x" at 1,2
  2140.  To set a label of the sign Sigma of size 24 at center of plot area, use:
  2141.           set label "S" at graph 1,2 font "Symbol,24"
  2142.  To set a label "y=x^2" with the right of the text at (2,3,4), and tag the
  2143.  label as number 3, use:
  2144.           set label 3 "y=x^2" at 2,3,4 right
  2145.  To change the preceding label to center justification, use:
  2146.           set label 3 center
  2147.  To delete label number 2, use:
  2148.           set nolabel 2
  2149.  To delete all labels, use:
  2150.           set nolabel
  2151.  To show all labels (in tag order), use:
  2152.           show label
  2153.  To set a label on a plot with a timeseries (timefmt="%d/%m/%y,%H:%M) on the
  2154.  x axis, use something like:
  2155.           set label "Harvest" at "25/8/93",1
  2156.  The command `set lmargin` sets the size of the left margin.  Please see
  2157.  `set margins` for details.
  2158. ?set logscale
  2159. ?set nologscale
  2160. ?show logscale
  2161. ?logscale
  2162. ?nologscale
  2163.  Log scaling may be set on the x, y, z, x2 and/or y2 axes.
  2164.  
  2165.  Syntax:
  2166.          set logscale <axes> <base>
  2167.          set nologscale <axes>
  2168.          show logscale
  2169.  
  2170.  where <axes> may be any combinations of `x`, `y`, and `z`, in any order, or
  2171.  `x2` or `y2` and where <base> is the base of the log scaling.  If <base> is
  2172.  not given, then 10 is assumed.  If <axes> is not given, then all axes are
  2173.  assumed.  `set nologscale` turns off log scaling for the specified axes.
  2174.  
  2175.  Examples:
  2176.  
  2177.  To enable log scaling in both x and z axes:
  2178.         set logscale xz
  2179.  To enable scaling log base 2 of the y axis:
  2180.         set logscale y 2
  2181.  To disable z axis log scaling:
  2182.         set nologscale z
  2183. ?set missing
  2184. ?missing
  2185.  The `set missing` command allows you to tell `gnuplot` what character is
  2186.  used in a data file to denote missing data.
  2187.  
  2188.  Syntax:
  2189.          set missing {"character"}
  2190.  
  2191.  Example:
  2192.          set missing "?"
  2193.  
  2194.  would mean that, when plotting a file containing
  2195.  
  2196.          1 1
  2197.          2 ?
  2198.          3 2
  2199.  
  2200.  the middle line would be ignored.
  2201.  
  2202.  There is no default character for `missing`.
  2203.  Minor tic marks along the x2 axis are controlled by `set mx2tics`.  Please
  2204.  see `set mxtics'.
  2205.  Minor tic marks along the y2 axis are controlled by `set my2tics`.  Please
  2206.  see `set mxtics'.
  2207. ?set mapping
  2208. ?show mapping
  2209. ?mapping
  2210.  If data are provided to `splot` in spherical or cylindrical co-ordinates,
  2211.  the `set mapping` command should be used to instruct `gnuplot` how to
  2212.  interpret them.
  2213.  
  2214.  Syntax:
  2215.          set mapping { cartesian | spherical | cylindrical }
  2216.  
  2217.  For a spherical co-ordinate system, the data occupy two columns, which are
  2218.  interpreted as the polar and azimuthal angles theta and phi (in the units
  2219.  specified by `set angles`) and the mapping is:
  2220.  
  2221.          x = cos( theta ) * cos( phi )
  2222.          y = sin( theta ) * cos( phi )
  2223.          z = sin( phi )
  2224.  
  2225.  For a cylindrical co-ordinate system, the again occupy two columns, which are
  2226.  interpreted as theta (in the units specified by `set angles`) and z:
  2227.  
  2228.          x = cos( theta )
  2229.          y = sin( theta )
  2230.          z = z
  2231.  
  2232.  The effects of `mapping` can be duplicated with the `using` filter on the
  2233.  `splot` command, but `mapping` may be more convenient if many data files are
  2234.  to be processed.
  2235.  
  2236.  `mapping` has no affect on data file `plot`s.
  2237. ?set margin
  2238. ?show margin
  2239. ?margin
  2240. ?set bmargin
  2241. ?show bmargin
  2242. ?bmargin
  2243. ?set lmargin
  2244. ?show lmargin
  2245. ?lmargin
  2246. ?set rmargin
  2247. ?show rmargin
  2248. ?rmargin
  2249. ?set tmargin
  2250. ?show tmargin
  2251. ?tmargin
  2252.  Normally the margins of the plot are automatically calculated based on tics
  2253.  and axis labels.  These computed values can be overridden by the `set margin`
  2254.  commands.  `show margin` shows the current settings.
  2255.  
  2256.  Syntax:
  2257.          set bmargin {<margin>}
  2258.          set lmargin {<margin>}
  2259.          set rmargin {<margin>}
  2260.          set tmargin {<margin>}
  2261.          show margin
  2262.  
  2263.  The units of <margin> are character heights or widths, as appropriate.  A
  2264.  positive value always adds to the size of the margin.  Omitting it causes
  2265.  `gnuplot` to revert to the computed values.
  2266. ?set multiplot
  2267. ?multiplot
  2268. ?set nomultiplot
  2269.  The command `set multiplot` places `gnuplot` in the multiplot mode, in which
  2270.  several plots are placed on the same page, window, or screen.
  2271.  
  2272.  Syntax:
  2273.          set multiplot
  2274.          set nomultiplot
  2275.  
  2276.  For some terminals, no plot is displayed until the command `set nomultiplot`
  2277.  is given, which causes the entire page to be drawn and then returns `gnuplot`
  2278.  to its normal single-plot mode.  For other terminals, each separate `plot`
  2279.  command produces a plot.
  2280.  
  2281.  The commands `set origin` and `set size` must be used to correctly position
  2282.  each plot; see `set origin` and `set size` for details of their usage.
  2283.  
  2284.  Example:
  2285.          set multiplot
  2286.          set size 1.0,0.5
  2287.          set origin 0.0,0.0; plot sin(x)
  2288.          set origin 0.0,0.5; plot cos(x)
  2289.          set nomultiplot
  2290.  
  2291.  displays a plot of cos(x) stacked above a plot of sin(x).
  2292. ?set mxtics
  2293. ?set nomxtics
  2294. ?show mxtics
  2295. ?mxtics
  2296. ?nomxtics
  2297. ?set mytics
  2298. ?set nomytics
  2299. ?show mytics
  2300. ?mytics
  2301. ?nomytics
  2302. ?set mztics
  2303. ?set nomztics
  2304. ?show mztics
  2305. ?mztics
  2306. ?nomztics
  2307. ?set mx2tics
  2308. ?set nomx2tics
  2309. ?show mx2tics
  2310. ?mx2tics
  2311. ?nomx2tics
  2312. ?set my2tics
  2313. ?set nomy2tics
  2314. ?show my2tics
  2315. ?my2tics
  2316. ?nomy2tics
  2317.  Minor tic marks along the x axis are controlled by `set mx2tics`.  They can
  2318.  be turned off with `set nomxtics`.  Similar commands control minor tics along
  2319.  the other axes.
  2320.  
  2321.  Syntax:
  2322.          set mxtics {<freq>}
  2323.          set mytics {<freq>}
  2324.          set mztics {<freq>}
  2325.          set mx2tics {<freq>}
  2326.          set my2tics {<freq>}
  2327.          set nomxtics
  2328.          etc.
  2329.          show mxtics
  2330.          etc.
  2331.  
  2332.  <freq> is the number of sub-intervals (NOT the number of minor tics!) between
  2333.  major tics (ten is the default, so there are nine minor tics between major
  2334.  tics).
  2335.  
  2336.  If the axis is logarithmic, the number of sub-intervals will be set to a
  2337.  reasonable number by default (based upon the length of a decade).  This will
  2338.  be overridden if <freq> is given.  However the usual minor tics (2, 3, ...,
  2339.  8, 9 between 1 and 10, for example) are obtained by setting <freq> to 10,
  2340.  even though there are but nine sub-intervals.
  2341.  
  2342.  By default, minor tics are off for linear axes and on for logarithmic axes.
  2343.  They inherit the settings for `axis|border` and `{no}mirror` specified for
  2344.  the major tics.  Please see `set xtics` for information about these.
  2345.  Minor tic marks along the y axis are controlled by `set mytics`.  Please
  2346.  see `set mxtics'
  2347.  Minor tic marks along the z axis are controlled by `set mztics`.  Please
  2348.  see `set mxtics'
  2349. ?set offsets
  2350. ?noset offsets
  2351. ?show offsets
  2352. ?offsets
  2353.  Offsets provide a mechanism to put a boundary around the data inside of an
  2354.  autoscaled plot.
  2355.  
  2356.  Syntax:
  2357.          set offsets <left>, <right>, <top>, <bottom>
  2358.          set nooffsets
  2359.          show offsets
  2360.  
  2361.  Each offset may be a constant or an expression.  Each defaults to 0.  Left
  2362.  and right offsets are given in units of the x axis, top and bottom offsets in
  2363.  units of the y axis.  A positive offset expands the plot in the specified
  2364.  direction, e.g., a positive bottom offset makes ymin more negative.  Negative
  2365.  offsets, while permitted, can have unexpected interactions with autoscaling
  2366.  and clipping.
  2367.  
  2368.  Offsets are ignored in `splot`s.
  2369.  
  2370.  Example:
  2371.          set offsets 0, 0, 2, 2
  2372.          plot sin(x)
  2373.  
  2374.  This plot of sin(x) will have a y range [-3:3] because the function
  2375.  will be autoscaled to [-1:1] and the vertical offsets are each two.
  2376. ?set origin
  2377. ?origin
  2378.  The `set origin` command is used to specify the origin of a plotting surface
  2379.  (i.e., the graph and its margins) on the screen.  The co-ordinates are given
  2380.  in the `screen` co-ordinate system (see `co-ordinates` for information about
  2381.  this system).
  2382.  
  2383.  Syntax:
  2384.          set origin <x-origin>,<y-origin>
  2385. ?set output
  2386. ?show output
  2387. ?output
  2388.  By default, plots are displayed to the standard output. The `set output`
  2389.  command redirects the display to the specified file or device.
  2390.  
  2391.  Syntax:
  2392.          set output {"<filename>"}
  2393.          show output
  2394.  
  2395.  The filename must be enclosed in quotes.  If the filename is omitted, any
  2396.  output file opened by a previous invocation of `set output` will be closed
  2397.  and new output will be sent to the standard output.  MSDOS users should note
  2398.  that the \ character has special significance in double-quoted strings, so
  2399.  single-quotes should be used for filenames in different directories.
  2400.  
  2401.  On machines with popen functions (Unix), output can be piped through a shell
  2402.  command if the first character of the filename is '|'.  For instance,
  2403.  
  2404.          set output "|lpr -Plaser filename"
  2405.          set output "|lp -dlaser filename"
  2406.  
  2407.  On MSDOS machines, `set output "PRN"` will direct the output to the default
  2408.  printer.  On VMS, output can be sent directly to any spooled device.  It is
  2409.  also possible to send the output to DECnet transparent tasks, which allows
  2410.  some flexibility.
  2411. ?set parametric
  2412. ?set noparametric
  2413. ?show parametric
  2414. ?parametric
  2415. ?noparametric
  2416.  The `set parametric` command changes the meaning of `plot` (`splot`) from
  2417.  normal functions to parametric functions.  The command `set noparametric`
  2418.  restores the plotting style to normal, single-valued expression plotting.
  2419.  
  2420.  Syntax:
  2421.          set parametric
  2422.          set noparametric
  2423.          show parametric
  2424.  
  2425.  For 2-d plotting, a parametric function is determined by a pair of parametric
  2426.  functions operating on a parameter.  An example of a 2-d parametric function
  2427.  would be `plot sin(t),cos(t)`, which draws a circle (if the aspect ratio is
  2428.  set correctly---see `set size`).  `gnuplot` will display an error message if
  2429.  both functions are not provided for a parametric `plot`.
  2430.  
  2431.  For 3-d plotting, the surface is described as x=f(u,v), y=g(u,v), z=h(u,v).
  2432.  Therefore a triplet of functions is required.  An example of a 3-d parametric
  2433.  function would be `cos(u)*cos(v),cos(u)*sin(v),sin(u)`, which draws a sphere.
  2434.  `gnuplot` will display an error message if all three functions are not
  2435.  provided for a parametric `splot`.
  2436.  
  2437.  The total set of possible plots is a superset of the simple f(x) style plots,
  2438.  since the two functions can describe the x and y values to be computed
  2439.  separately.  In fact, plots of the type t,f(t) are equivalent to those
  2440.  produced with f(x) because the x values are computed using the identity
  2441.  function.  Similarly, 3-d plots of the type u,v,f(u,v) are equivalent to
  2442.  f(x,y).
  2443.  
  2444.  Note that the order the parametric functions are specified is xfunction,
  2445.  yfunction (and zfunction) and that each operates over the common parametric
  2446.  domain.
  2447.  
  2448.  Also, the `set parametric` function implies a new range of values.  Whereas
  2449.  the normal f(x) and f(x,y) style plotting assume an xrange and yrange (and
  2450.  zrange), the parametric mode additionally specifies a trange, urange, and
  2451.  vrange.  These ranges may be set directly with `set trange`, `set urange`,
  2452.  and `set vrange`, or by specifying the range on the `plot` or `splot`
  2453.  commands.  Currently the default range for these parametric variables is
  2454.  [-5:5].  Setting the ranges to something more meaningful is expected.
  2455. ?set pointsize
  2456. ?show pointsize
  2457. ?pointsize
  2458.  The `set pointsize` command changes the size of the points used in plots.
  2459.  
  2460.  Syntax:
  2461.          set pointsize <pointsize>
  2462.          show pointsize
  2463.  
  2464.  Default is pointsize 1.0.  Larger pointsizes (>1.0) are useful for high
  2465.  resolution in bitmapped graphics.
  2466.  
  2467.  Please note that the pointsize setting is not supported with all terminal
  2468.  types.
  2469. ?set encoding
  2470. ?show encoding
  2471. ?encoding
  2472.  The 'set encoding' command selects a character encoding.  Valid values
  2473.  are 'default', which does nthing, 'iso_8859_1' (which is used on many
  2474.  Unix workstations, and with MS-Windows), and 'cp437', the standard
  2475.  IBM PC character encoding.
  2476.  
  2477.  Syntax:
  2478.  
  2479.  Please  note that this is not supported on all terminal types, and that
  2480.  cp437 still needs to be done.
  2481. ?set polar
  2482. ?set nopolar
  2483. ?show polar
  2484. ?polar
  2485. ?nopolar
  2486.  The `set polar` command changes the meaning of the plot from rectangular
  2487.  co-ordinates to polar co-ordinates.
  2488.  
  2489.  Syntax:
  2490.          set polar
  2491.          set nopolar
  2492.          show polar
  2493.  
  2494.  There have been changes made to polar mode in version 3.6, so that scripts
  2495.  for `gnuplot` versions 3.5 and earlier will require modification.  The main
  2496.  change is that the dummy variable t is used for the angle so that the x and
  2497.  y ranges can be controlled independently.  Other changes are:
  2498.  1) tics are no longer put along the zero axes automatically
  2499.  ---use `set [x|y]tics axis nomirror`;
  2500.  2) the grid, if selected, is not automatically polar
  2501.  ---use `set grid polar`;
  2502.  3) the grid is not labelled with angles
  2503.  ---use `set label` as necessary.
  2504.  
  2505.  In polar co-ordinates, the dummy variable (t) is an angle.  The default range
  2506.  of t is [0:2*pi], or, if degree units have been selected, to [0:360] (see
  2507.  `set angles`).
  2508.  
  2509.  The command `set nopolar` changes the meaning of the plot back to the default
  2510.  rectangular co-ordinate system.
  2511.  
  2512.  The `set polar` command is not supported for `splot`s.  See the `set mapping`
  2513.  command for similar functionality for `splot`s.
  2514.  
  2515.  While in polar co-ordinates the meaning of an expression in t is really
  2516.  r = f(t), where t is an angle of rotation.  The trange controls the domain
  2517.  (the angle) of the function, and the x and y ranges control the range of the
  2518.  plot in the x and y directions.
  2519.  
  2520.  Example:
  2521.          set polar
  2522.          plot t*sin(t)
  2523.          plot [-2*pi:2*pi] [-3:3] [-3:3] t*sin(t)
  2524.  
  2525.  The first `plot` uses the default polar angular domain of 0 to 2*pi.  The
  2526.  radius and the size of the plot are scaled automatically.  The second `plot`
  2527.  expands the domain, and restricts the size of the plot to [-3:3] in both
  2528.  directions.
  2529.  
  2530.  You may want to `set size square` to have `gnuplot` try to make the aspect
  2531.  ratio equal to unity, so that circles look circular.
  2532.  The command `set rmargin` sets the size of the right margin.  Please see
  2533.  `set margins` for details.
  2534. ?set rrange
  2535. ?show rrange
  2536. ?rrange
  2537.  For a polar plot, the radial co-ordinate should be non-negative, but `rrange`
  2538.  can be used to move the singularity.
  2539.  
  2540.  Syntax:
  2541.          set rrange {[<rmin>:<rmax>]}
  2542.          show rrange
  2543.  
  2544.  `rmin` specifies the radius at the origin and `rmax` provides clipping for
  2545.  large radii.  `xrange` and `yrange` are affected---the ranges can be set as
  2546.  if the plot was of r(t)-rmin, with rmin added to all the labels.  (`set term
  2547.  table` reveals that it is in fact implemented that way.)
  2548. ?set samples
  2549. ?show samples
  2550. ?samples
  2551.  The sampling rate of functions may be changed by the `set samples` command.
  2552.  
  2553.  Syntax:
  2554.          set samples <samples_1> {,<samples_2>}
  2555.          show samples
  2556.  
  2557.  By default, sampling is set to 100 points.  A higher sampling rate will
  2558.  produce more accurate plots, but will take longer.  This parameter no longer
  2559.  has any effect on data-file plotting.
  2560.  
  2561.  When a 2-d plot is being done, only the value of <samples_1> is relevant.
  2562.  
  2563.  When a surface plot is being done without the removal of hidden lines, the
  2564.  value of samples specifies the number of samples that are to be evaluated for
  2565.  isoline.  Each iso-v line will have <sample_1> samples and each iso-u line
  2566.  will have <sample_2> samples.  If you only specify <samples_1>, <samples_2>
  2567.  will be set to the same value as <samples_1>.  See also `set isosamples`.
  2568. ?set size
  2569. ?show size
  2570. ?size
  2571.  The `set size` command scales the displayed size of the plot.
  2572.  
  2573.  Syntax:
  2574.          set size {{no}square} {<xscale>,<yscale>}
  2575.          show size
  2576.  
  2577.  The <xscale> and <yscale> values are the scaling factors for the size.  The
  2578.  defaults (1,1) are selected if the scaling factors are omitted.  If `square`
  2579.  is specified, `gnuplot` will attempt to make the plot area square, to give
  2580.  polar plots the correct aspect ratio, for example.  Success depends on the
  2581.  terminal driver selected.  The plot area will be the largest square that will
  2582.  fit into the specified portion of the output.
  2583.  
  2584.  Note that the size of the plot includes the space used by the labels; the
  2585.  plotting area itself is smaller.  `square` takes only the plotting area into
  2586.  account.
  2587.  
  2588.  If `set key out` is specified, the key is drawn at the far right edge of the
  2589.  usable area---you can use something like
  2590.     `set size square 0.9,1`
  2591.  to bring it closer to the square plotting area.
  2592.  
  2593.  On some terminals, changing the size of the plot will result in text being
  2594.  misplaced.  Increasing the size of the plot may produce strange results.
  2595.  Decreasing is safer.
  2596.  
  2597.  Examples:
  2598.  
  2599.  To set the size to normal size use:
  2600.          set size 1,1
  2601.  To make the plot half size and square use:
  2602.          set size square 0.5,0.5
  2603.  To show the size use:
  2604.          show size
  2605.  
  2606.  For the LaTeX and Fig terminals the default size (scale factor 1,1) is 5
  2607.  inches wide by 3 inches high.  The big Fig terminal (`bfig`) is 7 inches wide
  2608.  by 5 inches high.  The PostScript default is landscape mode 10 inches wide
  2609.  and 7 inches high; portrait mode has these dimensions reversed, and EPS cuts
  2610.  them in half.
  2611. ?set style
  2612. ?show style
  2613.  Default styles are chosen with the `set function style` and `set data style`
  2614.  commands.  See `plot style` for information about how to override the default
  2615.  plotting style for individual functions and data sets.
  2616.  
  2617.  Syntax:
  2618.          set function style <style>
  2619.          set data style <style>
  2620.          show function style
  2621.          show data style
  2622.  
  2623.  The types used for all line and point styles (i.e., solid, dash-dot, color,
  2624.  etc. for lines; circles, squares, crosses, etc. for points) will be either
  2625.  those specified on the `plot` or `splot` command or will be chosen
  2626.  sequentially from the types available to the terminal in use.  Use the
  2627.  command `test` to see what is available.
  2628.  
  2629.  None of the `errorbars` styles can be used with `splot`s or function `plot`s.
  2630.  If one is specified, it will be changed to `points`.
  2631.  
  2632.  For 2-d data with more than two columns, `gnuplot` is picky about the allowed
  2633.  `errorbar` styles:
  2634.  
  2635.  For three columns, only `xerrorbars`, `yerrorbars` (or `errorbars`), `boxes`,
  2636.  and `boxerrorbars` are allowed.  If another plot style is used, the style
  2637.  will be changed to `yerrorbars`.  The `boxerrorbars` style will calculate the
  2638.  boxwidth automatically.
  2639.  
  2640.  For four columns, only `xerrorbars`, `yerrorbars` (or `errorbars`),
  2641.  `xyerrorbars`, `boxxyerrorbars`, and `boxerrorbars`, are allowed.  An illegal
  2642.  plot style will be changed to `yerrorbars`.
  2643.  
  2644.  Five-column data allow only the `boxerrorbars` style.  An illegal style will
  2645.  be changed to `boxerrorbars` before plotting.
  2646.  
  2647.  Six- and seven-column data only allow the `xyerrorbars` and `boxxyerrorbars`
  2648.  styles.  Illegal styles will be changed to `xyerrorbars` before plotting.
  2649.  
  2650.  Use the `using` option on the `plot` command to set up the correct number of
  2651.  columns for the style you want.
  2652.  
  2653. ?style
  2654. ?set style lines
  2655. ?style lines
  2656. ?lines
  2657.  The `lines` style connects adjacent points with straight line segments.
  2658. ?set style points
  2659. ?style points
  2660. ?points
  2661.  The `points` style displays a small symbol at each point.  The command `set
  2662.  pointsize` may be used to change the size of the points.  See `set pointsize`
  2663.  for its usage.
  2664. ?set style linespoints
  2665. ?style linespoints
  2666. ?linespoints
  2667.  The `linespoints` style does both `lines` and `points`, that is, it draws a
  2668.  small symbol at each point and then connects adjacent points with straight
  2669.  line segments.  The command `set pointsize` may be used to change the size of
  2670.  the points.  See `set pointsize` for its usage.
  2671. ?set style impulses
  2672. ?style impulses
  2673. ?impulses
  2674.  The `impulses` style displays a vertical line from the x axis (not the plot
  2675.  border), or from the grid base for `splot`, to each point.
  2676. ?set style dots
  2677. ?style dots
  2678. ?dots
  2679.  The `dots` style plots a tiny dot at each point; this is useful for scatter
  2680.  plots with many points.
  2681. ?set style steps
  2682. ?style steps
  2683. ?steps
  2684.  The `steps` style is only relevant to 2-d plotting.  It connects consecutive
  2685.  points with two line segments: the first from (x1,y1) to (x2,y1) and the
  2686.  second from (x2,y1) to (x2,y2).
  2687. ?set style fsteps
  2688. ?style fsteps
  2689. ?fsteps
  2690.  The `fsteps` style is only relevant to 2-d plotting.  It connects consecutive
  2691.  points with two line segments: the first from (x1,y1) to (x1,y2) and the
  2692.  second from (x1,y2) to (x2,y2).
  2693. ?set style boxes
  2694. ?style boxes
  2695. ?boxes
  2696. ?set style bargraph
  2697. ?style bargraph
  2698. ?bargraph
  2699.  The `boxes` style is only relevant to 2-d plotting.  It draws a box centered
  2700.  about the given x co-ordinate from the x axis (not the plot border) to the
  2701.  given y co-ordinate.  The width of the box is obtained in one of three ways.
  2702.  If it is a data plot and the data file has a third column, this will be used
  2703.  to set the width of the box.  If not, if a width has been set using the `set
  2704.  boxwidth` command, this will be used.  If neither of these is available, the
  2705.  width of each box will be calculated automatically so that it touches the
  2706.  adjacent boxes.
  2707. ?set style boxerrorbars
  2708. ?style boxerrorbars
  2709. ?boxerrorbars
  2710.  The `boxerrorbars` style is only relevant to 2-d data plotting.  It is a
  2711.  combination of the `boxes` and `yerrorbars` styles.  The boxwidth will come
  2712.  from the fourth column if the y errors are in the form of "ydelta" and the
  2713.  boxwidth was not previously set equal to -2.0 (`set boxwidth -2.0`) or from
  2714.  the fifth column if the y errors are in the form of "ylow yhigh".  The
  2715.  special case  `boxwidth = -2.0` is for four-column data with y errors in the
  2716.  form "ylow yhigh".  In this case the boxwidth will be calculated so that each
  2717.  box touches the adjacent boxes.  The width will also be calculated in cases
  2718.  where three-column data are used.
  2719.  
  2720.  The box height is determined from the y error in the same way as it is for
  2721.  the `yerrorbars` style---either from y-ydelta to y+ydelta or from ylow to
  2722.  yhigh, depending on how many data columns are provided.
  2723. ?boxxyerrorbars
  2724. ?set style boxxyerrorbars
  2725. ?style boxxyerrorbars
  2726. ?boxxyerrorbars
  2727.  The `boxxyerrorbars` style is only relevant to 2-d data plotting.  It is a
  2728.  combination of the `boxes` and `xyerrorbars` styles.
  2729.  
  2730.  The box width and height are determined from the x and y errors in the same
  2731.  way as they are for the `xyerrorbars` style---either from xlow to xhigh and
  2732.  from ylow to yhigh, or from x-xdelta to x+xdelta and from y-ydelta to
  2733.  y+ydelta , depending on how many data columns are provided.
  2734. ?set style yerrorbars
  2735. ?style yerrorbars
  2736. ?yerrorbars
  2737. ?errorbars
  2738.  The `yerrorbars` (or `errorbars`) style is only relevant to 2-d data plots.
  2739.  `yerrorbars` is like `dots`, except that a vertical error bar is also drawn.
  2740.  At each point (x,y), a line is drawn from (x,y-ydelta) to (x,y+ydelta) or
  2741.  from (x,ylow) to (x,yhigh), depending on how many data columns are provided.
  2742.  A tic mark is placed at the ends of the error bar (unless `set bar small` is
  2743.  used).
  2744. ?set style xerrorbars
  2745. ?style xerrorbars
  2746. ?xerrorbars
  2747.  The `xerrorbars` style is only relevant to 2-d data plots.  `xerrorbars` is
  2748.  like `dots`, except that a horizontal error bar is also drawn.  At each point
  2749.  (x,y), a line is drawn from (xlow,y) to (xhigh,y) or from (x-xdelta,y) to
  2750.  (x+xdelta,y), depending on how many data columns are provided.  A tic mark
  2751.  is placed at the ends of the error bar (unless `set bar small` is used).
  2752. ?xyerrorbars
  2753.  The `xyerrorbars` style is only relevant to 2-d data plots.  `xyerrorbars` is
  2754.  like `dots`, except that horizontal and vertical error bars are also drawn.
  2755.  At each point (x,y), lines are drawn from (x,y-ydelta) to (x,y+ydelta) and
  2756.  from (x-xdelta,y) to (x+xdelta,y) or from (x,ylow) to (x,yhigh) and from
  2757.  (xlow,y) to (xhigh,y), depending upon the number of data columns provided.  A
  2758.  tic mark is placed at the ends of the error bar (unless `set bar small` is
  2759.  used).
  2760.  
  2761.  If data are provided in an unsupported mixed form, the `using` filter on the
  2762.  `plot` command should be used to set up the appropriate form.  For example,
  2763.  if the data are of the form (x,y,xdelta,ylow,yhigh), then you can use
  2764.  
  2765.         plot 'data' using 1:2:($1-$3),($1+$3),4,5 with xyerrorbars
  2766. ?set style bezier
  2767. ?style bezier
  2768. ?bezier
  2769.  The `bezier` style connects adjacent points with Bezier curves.
  2770. ?set style sbezier
  2771. ?style sbezier
  2772. ?sbezier
  2773.  The `sbezier` style connects adjacent points with some other Bezier curves.
  2774. ?set style splines
  2775. ?style splines
  2776. ?splines
  2777.  The `splines` style connects adjacent points with quadratic splines.
  2778. ?set style csplines
  2779. ?style csplines
  2780. ?csplines
  2781.  The `csplines` style connects adjacent points with cubic splines.
  2782. ?set style vectors
  2783. ?style vectors
  2784. ?vectors
  2785.  The `vectors` style draws a vector from (x,y) to (x+xdelta,y+ydelta).  Thus
  2786.  it requires four columns of data.  It also draws a small arrowhead at the
  2787.  end of the vector.
  2788.  
  2789.  The `vectors` style is still experimental: it doesn't get clipped properly
  2790.  and other things may also be wrong with it.  Use it at your own risk.
  2791. ?set surface
  2792. ?set nosurface
  2793. ?show surface
  2794. ?surface
  2795.  The command `set surface` controls the display of surfaces, which are drawn
  2796.  as a mesh of isolines.
  2797.  
  2798.  Syntax:
  2799.          set surface
  2800.          set nosurface
  2801.          show surface
  2802.  
  2803.  Whenever `set nosurface` is issued, no surface isolines/mesh will be drawn.
  2804.  This is useful if contours are to be displayed by themselves.  See also `set
  2805.  contour`.
  2806. ?set terminal
  2807. ?show terminal
  2808. ?terminal
  2809.  `gnuplot` supports many different graphics devices.  Use the `set terminal`
  2810.  command to select the type of device for which `gnuplot` will produce output.
  2811.  
  2812.  Syntax:
  2813.          set terminal {<terminal-type>}
  2814.          show terminal
  2815.  
  2816.  If <terminal-type> is omitted, `gnuplot` will list the available terminal
  2817.  types.  <terminal-type> may be abbreviated.
  2818.  
  2819.  Use `set output` to redirect this output to a file or device.
  2820.  
  2821.  Several terminals have additional options.  For example, see `dumb`,
  2822.  `iris4d`, `hpljii` or `postscript`.
  2823. ?set terminal aifm
  2824. ?aifm
  2825.  Several options may be set in the Adobe Illustrator 3.0 driver.
  2826.  
  2827.  Syntax:
  2828.          set terminal aifm {<color>}
  2829.                                  {"<fontname>"} {<fontsize>}
  2830.  
  2831.  <color> is either `color` or `monochrome`; "<fontname>" is the name of a
  2832.  valid PostScript font; <fontsize> is the size of the font in PostScript
  2833.  points, before scaling by the `set size` command.  Selecting `default` sets
  2834.  all options to their default values: `monochrome`, "Helvetica", and 14pt.
  2835.  
  2836.  Also, since AI does not really support multiple pages, multiple graphs will
  2837.  be output directly on top of one another.  However, each graph will be
  2838.  grouped individually, making it easy to separate them inside AI (just pick
  2839.  them up and move them).
  2840.  
  2841.  Examples:
  2842.  
  2843.          set term aifm
  2844.          set term aifm 22
  2845.          set size 0.7,1.4
  2846.          set term aifm color "Times-Roman" 14
  2847. ?set terminal atari
  2848. ?atari
  2849.  The `atari` terminal has options to set the character size and the screen
  2850.  colors.  The driver expects a space-separated list containing the character
  2851.  size and up to 16 three-digit hex numbers, where each digit represents RED,
  2852.  GREEN and BLUE (in that order).  The range of 0--15 is scaled to whatever
  2853.  color range the screen actually has.  On a normal ST screen, odd and even
  2854.  intensities are the same.
  2855.  
  2856.  Examples:
  2857.  
  2858.         set terminal atari 4 # (use small (6x6) font)
  2859.         set terminal atari 6 0 # (set monochrome screen to white on black)
  2860.         set terminal atari 13 0 fff f00 f0 f ff f0f ff0
  2861.         # (set first eight colors to black, white, green, blue, cyan, \
  2862.           purple, and yellow and use large font (8x16).)
  2863.  
  2864.  Additionally, if an environment variable GNUCOLORS exists, its contents are
  2865.  interpreted as an options string, but an explicit terminal option takes
  2866.  precedence.
  2867. ?set terminal vdi
  2868. ?vdi
  2869.  This terminal is the same as the `atari` terminal, except for the fact that
  2870.  it sends output to the screen via the VDI and not into AES-Windows.)
  2871.  
  2872.  The `vdi` terminal has the same options as the `atari` terminal.
  2873.  
  2874. ?set terminal mtos
  2875. ?mtos
  2876.  The `mtos` terminal has no options.  It sends data via a pipe to an external
  2877.  program called GPCLIENT.  It runs under MiNT, MULTITOS, Magic 3.0 and MagicMAC.
  2878.  
  2879.  If you cannot find GPCLIENT, please send an email to:
  2880.  
  2881.              dirk@lstm.uni-erlangen.de
  2882. ?set terminal dumb
  2883. ?dumb
  2884.  The dumb terminal driver has an optional size specification.
  2885.  
  2886.  Syntax:
  2887.          set terminal dumb {<xsize> <ysize>}
  2888.  
  2889.  where <xsize> and <ysize> set the size of the dumb terminals. Default is
  2890.  79 by 24.
  2891.  
  2892.  Examples:
  2893.          set term dumb
  2894.          set term dumb 79 49 # VGA screen---why would anyone want to do that?
  2895. ?set terminal epson
  2896. ?set terminal epson180
  2897. ?set terminal epson60
  2898. ?set terminal starc
  2899. ?set terminal tandy60
  2900. ?epson
  2901.  This set of drivers support Epson printers and derivatives.  `epson` is a
  2902.  generic 9-wire printer with a resolution of 512x384.  `starc` is a Star Color
  2903.  printer with the same resolution.  `epson180` and `epson60` are 180-dpi and
  2904.  60-dpi drivers for newer 24-wire printers.  This also includes bubble jet
  2905.  printers.  Their resolutions are 1260x1080 and 480x360, respectively.  The
  2906.  `tandy60` is identical to the `epson60` driver with one additional escape
  2907.  sequence to start IBM mode.
  2908.  
  2909.  With all of these drivers, a binary copy is required on a PC to print.  Do
  2910.  not use `print`:
  2911.  
  2912.         copy file /b lpt1:
  2913. ?set terminal gpic
  2914. ?gpic
  2915.  This driver is only known to work with the Free Software Foundation
  2916.  gpic/groff package.  Modification for the Document Workbench pic/troff
  2917.  package would be appreciated.  FSF gpic can also produce TeX output.
  2918.  
  2919.  A simple graph can be formatted using
  2920.  
  2921.       groff -p -mpic -Tps file.pic > file.ps.
  2922.  
  2923.  The output from pic can be pipe-lined into eqn, so it is possible to put
  2924.  complex functions in a graph with the set label and set {x/y}label commands.
  2925.  For instance,
  2926.  
  2927.     set ylab '@space 0 int from 0 to x alpha ( t ) roman d t@'
  2928.  
  2929.  will label the y axis with a nice integral if formatted with the command:
  2930.  
  2931.     gpic filename.pic | geqn -d@@ -Tps | groff -m[macro-package] -Tps
  2932.          > filename.ps
  2933.  
  2934.  Figures made this way can be scaled to fit into a document.  The pic language
  2935.  is easy to understand, so the graphs can be edited by hand if need be.  All
  2936.  co-ordinates in the pic-file produced by `gnuplot` are given as x+gnuplotx
  2937.  and y+gnuploty.  By default x and y are given the value 0.  If this line is
  2938.  removed with an editor in a number of files, one can put several graphs in
  2939.  one figure like this (default size is 5.0x3.0 inches):
  2940.  
  2941.     .PS 8.0
  2942.     x=0;y=3
  2943.     copy "figa.pic"
  2944.     x=5;y=3
  2945.     copy "figb.pic"
  2946.     x=0;y=0
  2947.     copy "figc.pic"
  2948.     x=5;y=0
  2949.     copy "figd.pic"
  2950.     .PE
  2951.  
  2952.  This will produce an 8-inch-wide figure with four graphs in two rows on top
  2953.  of each other.
  2954.  
  2955.  One can also achieve the same thing by the command
  2956.  
  2957.    set term pic x y
  2958.  
  2959.  For example, using
  2960.  
  2961.    .PS 6.0
  2962.    copy "trig.pic"
  2963.    .PE
  2964. ?set terminal hpljii
  2965. ?hpljii
  2966.  The HP LaserJet II and HP DeskJet drivers have a single option.
  2967.  
  2968.  Syntax:
  2969.          set terminal hpljii {<resolution>}
  2970.          set terminal hpdj   {<resolution>}
  2971.  
  2972.  where <resolution> is the resolution of the output in dots per inch.  It must
  2973.  be `75`, `100`, `150` or `300`.  Note: there must be enough memory available
  2974.  to rasterize at the higher resolutions.
  2975.  
  2976.  Example:
  2977.          set terminal hpljii 150
  2978. ?set terminal imagen
  2979. ?imagen
  2980.  The imagen driver is able to draw several plots on each page (in either
  2981.  portrait or landscape orientation), and fontsize may also be specified.
  2982.  
  2983.  Options are:
  2984.        portrait
  2985.        landscape        (default)
  2986.        [ x , y ]        (where x and y are the number of plots in the x and y
  2987.                          directions on the page)
  2988.        n                (where n is fontsize in points)
  2989.  
  2990.  To plot 6 plots per page in two columns in portrait orientation:
  2991.        set term imagen po [2,3]
  2992.  
  2993. ?set terminal iris4d
  2994. ?iris4d
  2995.  The iris4d driver can operate in two modes.
  2996.  
  2997.  Syntax:
  2998.          set terminal iris4d {24}
  2999.  
  3000.  If the hardware supports only 8 bits, use the default `set terminal iris4d`.
  3001.  If, however, the hardware supports 24 bits (8 per red/green/blue), use `set
  3002.  terminal iris4d 24`.
  3003.  
  3004.  When using 24-bit mode, the colors can be directly specified via the file
  3005.  .gnuplot_iris4d that is searched in the current directory and then in the
  3006.  home directory specified by the HOME environment variable.  This file holds
  3007.  RGB values for the background, border, labels and nine plotting colors, in
  3008.  that order.  For example, here is a file containing the default colors:
  3009.  
  3010.          85   85   85     /* Background */
  3011.          0    0    0      /* Boundary */
  3012.          170  0    170    /* Labeling */
  3013.          85   255  255    /* Plot Color 1 */
  3014.          170  0    0      /* Plot Color 2 */
  3015.          0    170  0      /* Plot Color 3 */
  3016.          255  85   255    /* Plot Color 4 */
  3017.          255  255  85     /* Plot Color 5 */
  3018.          255  85   85     /* Plot Color 6 */
  3019.          85   255  85     /* Plot Color 7 */
  3020.          0    170  170    /* Plot Color 8 */
  3021.          170  170  0      /* Plot Color 9 */
  3022.  
  3023.  This file has exactly 12 lines of RGB triples.  No empty lines are allowed
  3024.  and anything after the third number in line is ignored.
  3025. ?set terminal latex
  3026. ?latex
  3027.  The LaTeX and emTeX driver allows one to specify a font type and a font size
  3028.  for the labels around a `gnuplot` graph.
  3029.  
  3030.  Options are:
  3031.  Fonts:
  3032.        default          (Roman 10 point)
  3033.        courier
  3034.        roman
  3035.  
  3036.  at any size you specify.  (BEWARE: METAFONT will not like odd sizes.) e.g.
  3037.        gnuplot> set term latex courier 5
  3038.  
  3039.  Unless your driver is capable of building fonts at any size (e.g. dvips),
  3040.  stick to the standard 10, 11 and 12 point size.
  3041.  
  3042. ?set terminal linux
  3043. ?linux
  3044.  The Linux driver has no additional options to specify.  It looks at the
  3045.  environment variable GSVGAMODE for the default mode; if not set, it uses
  3046.  1024x768x256 as default mode or, if that is not possible, 640x480x16
  3047.  (standard VGA).
  3048.  
  3049.  Syntax:
  3050.          set terminal linux
  3051. ?set terminal mf
  3052. ?mf
  3053. ?metafont
  3054.  The mf terminal driver creates a input file to the METAFONT program.  Thus a
  3055.  figure may be used in the TeX document in the same way as a character is.
  3056.  
  3057.  To use the plot in a document the METAFONT program must be run with the
  3058.  output file from `gnuplot` as input.  Thus, the user needs a basic knowledge
  3059.  of the font creating process and the procedure for including a new font in a
  3060.  document.  However, if the METAFONT program is set up properly at the local
  3061.  site, an unexperienced user could perform the operation without much trouble.
  3062.  
  3063.  The text support is based on a METAFONT character set.  Currently the
  3064.  Computer Modern Roman font set is input, but the user is in principal free to
  3065.  chose whatever fonts he or she needs.  The METAFONT source files for the
  3066.  chosen font must be available.  Each character is stored in a separate
  3067.  picture variable in METAFONT.  These variables may be manipulated (rotated,
  3068.  scaled etc.) when characters are needed.  The drawback is the interpretation
  3069.  time in the METAFONT program.  On some machines (i.e. PC) the limited amount
  3070.  of memory available may also cause problems if too many pictures are stored.
  3071.  
  3072. ?set terminal mf detailed
  3073. ?mf detailed
  3074. ?metafont detailed
  3075.  
  3076.  - Set your terminal to METAFONT:
  3077.    set terminal mf
  3078.  - Select an output-file, e.g.:
  3079.    set output "myfigures.mf"
  3080.  - Do your plots. Each plot will generate a separate character. Its default
  3081.  size will be 5*3 inches. You can change the size by saying `set size 0.5,0.5`
  3082.  or whatever fraction of the default size you want to have.
  3083.  
  3084.  - Quit `gnuplot`.
  3085.  
  3086.  - Generate a TFM and GF file by running METAFONT on the output of `gnuplot`.
  3087.  Since the plot is quite large (5*3 in), you will have to use a version of
  3088.  METAFONT that has a value of at least 150000 for memmax.  On Unix systems
  3089.  these are conventionally installed under the name bigmf.  For the following
  3090.  assume that the command virmf stands for a big version of METAFONT.  For
  3091.  example:
  3092.  
  3093.  - Invoke METAFONT:
  3094.      virmf '&plain'
  3095.  - Select the output device: At the METAFONT prompt ('*') type:
  3096.      \mode:=CanonCX;     % or whatever printer you use
  3097.  - Optionally select a magnification:
  3098.      mag:=1;             % or whatever you wish
  3099.  - Input the `gnuplot`-file:
  3100.      input myfigures.mf
  3101.  On a typical Unix machine there will usually be a script called mf that
  3102.  executes virmf '&plain', so you probably can substitute mf for virmf &plain.
  3103.  This will generate two files: mfput.tfm and mfput.$$$gf (where $$$ indicates
  3104.  the resolution of your device).  The above can be conveniently achieved by
  3105.  typing everything on the command line, e.g.:
  3106.  virmf '&plain' '\mode:=CanonCX; mag:=1; input myfigures.mf'
  3107.  In this case the output files will be named myfigures.tfm and
  3108.  myfigures.300gf.
  3109.  
  3110.  - Generate a PK file from the GF file using gftopk:
  3111.    gftopk myfigures.300gf myfigures.300pk
  3112.  The name of the output file for gftopk depends on the DVI driver you use.
  3113.  Ask your local TeX administrator about the naming conventions.  Next, either
  3114.  install the TFM and PK files in the appropriate directories, or set your
  3115.  environment variables properly.  Usually this involves setting TEXFONTS to
  3116.  include the current directory and doing the same thing for the environment
  3117.  variable that your DVI driver uses (no standard name here...).  This step is
  3118.  necessary so that TeX will find the font metric file and your DVI driver will
  3119.  find the PK file.
  3120.  
  3121.  - To include your plots in your document you have to tell TeX the font:
  3122.    \font\gnufigs=myfigures
  3123.  Each plot you made is stored in a single character.  The first plot is
  3124.  character 0, the second is character 1, and so on...  After doing the above
  3125.  step, you can use the plots just like any other characters.  Therefore, to
  3126.  place plots 1 and 2 centered in your document, all you have to do is:
  3127.    \centerline{\gnufigs\char0}
  3128.    \centerline{\gnufigs\char1}
  3129.  in plain TeX.  For LaTeX you can, of course, use the picture environment and
  3130.  place the plot according to your wishes using the \makebox and \put macros.
  3131.  
  3132.  This conversion saves you a lot of time once you have generated the font,
  3133.  since TeX handles the plots as characters and uses minimal time to place
  3134.  them.  Also the documents you make change more often than the plots do.  Also
  3135.  it saves a lot of TeX memory.  One last advantage of using the METAFONT
  3136.  driver is that the DVI file really remains device independent, because no
  3137.  \special commands are used as in the eepic and tpic drivers.
  3138. ?set terminal mif
  3139. ?mif
  3140.  Several options may be set in the MIF 3.00 driver.
  3141.  
  3142.  Syntax:
  3143.       set terminal mif {<pentype>} {<curvetype>} {<help>}
  3144.  
  3145.  <pentype> selects "colour" of the graphics.
  3146.       `colour`     plot lines with line types >= 0 in colour (MIF sep. 2--7).
  3147.       `monochrome` plot all line types in black (MIF sep. 0).
  3148.  <curvetype> selects how "curves" are plotted.
  3149.       `polyline`   plot curves as continuous curves.
  3150.       `vectors`    plot curves as collections of vectors
  3151.  <help> print online help on standard error output.
  3152.       `help`       print a short description of the usage, and the options
  3153.       `?`          print a short description of the usage
  3154.  
  3155.  This terminal driver produces Frame Maker MIF format version 3.00.  It plots
  3156.  in MIF Frames with the size 15*10 [cm], and plot primitives with the same pen
  3157.  will be grouped in the same MIF group.  Plot primitives in a `gnuplot` plot
  3158.  will be plotted in a MIF Frame, and several MIF Frames are collected in one
  3159.  large MIF Frame.  Plot primitives with line types >= 0 will as default be
  3160.  drawn in color.  As default, curves are plotted as continuous lines.  The MIF
  3161.  font used for text is "Times".
  3162.  
  3163.  Examples:
  3164.  
  3165.       set term mif
  3166.       set term mif vectors
  3167.       set term mif help
  3168. ?set terminal nec-cp6
  3169. ?nec-cp6
  3170.  One option may be set in the nec-cp6 driver.  The resolution of this driver
  3171.  is 400x320.
  3172.  
  3173.  Syntax:
  3174.          set terminal nec-cp6 monochrome
  3175.          set terminal nec-cp6 color
  3176.          set terminal nec-cp6 draft
  3177. ?set terminal pbm
  3178. ?pbm
  3179.  Several options may be set in the PBMplus driver.
  3180.  
  3181.  Syntax:
  3182.          set terminal pbm {<fontsize>} {<colormode>}
  3183.  
  3184.  where <fontsize> is `small`, `medium`, or `large` and <colormode> is
  3185.  `monochrome`, `gray` or `color`.  Default size is 640 pixels wide and 480
  3186.  pixels high.  The output for `monochrome` is a portable bitmap (one bit per
  3187.  pixel).  The output for `gray` is a portable graymap (three bits per pixel).
  3188.  The output for `color` is a portable pixmap (color, four bits per pixel).
  3189.  The output of these drivers can be used with Jef Poskanzer's excellent
  3190.  PBMPLUS package, which provides programs to convert the above PBMPLUS formats
  3191.  to GIF, TIFF, MacPaint, Macintosh PICT, PCX, X11 bitmap and many others.
  3192.  
  3193.  Examples:
  3194.  
  3195.          set term pbm small
  3196.          set size 2,2
  3197.          set term pbm color medium
  3198. ?set terminal pcl5
  3199. ?pcl5
  3200.  Three options may be set in the pcl5 driver.  The driver actually uses HPGL-2
  3201.  but there is a name conflict among the terminal devices.
  3202.  
  3203.  Syntax:
  3204.          set terminal pcl5 {<mode>} {<font>} {<fontsize>}
  3205.  
  3206.  where <mode> is `landscape`, or `portrait`, <font> is `stick`, `univers`, or
  3207.  `cg_times`, and fontsize is the size in points.
  3208.  
  3209.  Example:
  3210.          set terminal pcl5 landscape
  3211.  
  3212. ?set terminal postscript
  3213. ?postscript
  3214.  Several options may be set in the PostScript driver.
  3215.  
  3216.  Syntax:
  3217.          set terminal postscript {<mode>} {<color>} {<dashed>} \
  3218.                               {<duplexing>} {"<fontname>"} {<fontsize>}
  3219.  
  3220.  where <mode> is `landscape`, `portrait`, `eps` or `default`; <color> is
  3221.  either `color` or `monochrome`; <dashed> is either `solid` or `dashed`;
  3222.  <duplexing> is `defaultplex`, `simplex` or `duplex` ("duplexing" in
  3223.  PostScript is the ability of the printer to print on both sides of the same
  3224.  page---don't set this if your printer can't do it); `"<fontname>"` is the
  3225.  name of a valid PostScript font; and `<fontsize>` is the size of the font in
  3226.  PostScript points.  Selecting `default` sets all options to their defaults:
  3227.  `landscape`, `monochrome`, `dashed`, `defaultplex`, "Helvetica", and 14pt.
  3228.  Default size of a PostScript plot is 10 inches wide and 7 inches high.
  3229.  
  3230.  EPS (Encapsulated PostScript) output is just regular PostScript with some
  3231.  lines added which allow the file to be imported into a variety of other
  3232.  applications.  (The added lines are PostScript comment lines, so the file may
  3233.  still be printed by itself.)  To get EPS output, use the `eps` mode and make
  3234.  only one plot per file.  In `eps` mode the whole plot is halved in size; the
  3235.  fonts are half the given size, and the plot is 5 inches wide and 3.5 inches
  3236.  high.
  3237.  
  3238.  Examples:
  3239.          set term postscript default       # old postscript
  3240.          set term postscript landscape 22  # old psbig
  3241.          set term postscript eps 14   # old epsf1
  3242.          set term postscript eps 22   # old epsf2
  3243.          set size 0.7,1.4
  3244.          set term post portrait color "Times-Roman" 14
  3245. ?set terminal enhpost
  3246. ?enhanced postscript
  3247. ?enhanced
  3248. ?enhpost
  3249.  The enhpost ("Enhanced PostScript") driver has extended capabilities beyond
  3250.  the regular PostScript driver.  Several options may be set in the enhpost
  3251.  driver.
  3252.  
  3253.  Syntax:
  3254.          set terminal enhpost {<mode>} {<color>} {<dashed>} \
  3255.                               {<duplexing>} {"<fontname>"} {<fontsize>}
  3256.  
  3257.  where <mode> is `landscape`, `portrait`, `eps` or `default`; <color> is
  3258.  either `color` or `monochrome`; <dashed> is either `solid` or `dashed`;
  3259.  <duplexing> is `defaultplex`, `simplex` or `duplex` ("duplexing" in
  3260.  PostScript is the ability of the printer to print on both sides of the same
  3261.  page---don't set this if your printer can't do it); `"<fontname>"` is the
  3262.  name of a valid PostScript font; and `<fontsize>` is the size of the font in
  3263.  PostScript points.  Selecting `default` sets all options to their defaults:
  3264.  `landscape`, `monochrome`, `dashed`, `defaultplex`, "Helvetica", and 14pt.
  3265.  Default size of an Enhanced PostScript plot is 10 inches wide and 7 inches
  3266.  high.
  3267.  
  3268.  EPS (Encapsulated PostScript) output is just regular PostScript with some
  3269.  lines added which allow the file to be imported into a variety of other
  3270.  applications.  (The added lines are PostScript comment lines, so the file may
  3271.  still be printed by itself.)  To get EPS output, use the `eps` mode and make
  3272.  only one plot per file.  In `eps` mode the whole plot is halved in size; the
  3273.  fonts are half the given size, and the plot is 5 inches wide and 3.5 inches
  3274.  high.
  3275.  
  3276.  Examples:
  3277.  
  3278.          set term enhpost landscape 22
  3279.          set term enhpost eps 14
  3280.          set term enhpost landscape simplex
  3281.          set size 0.7,1.4
  3282.          set term enhpost portrait color "Times-Roman" 14
  3283.  
  3284.  This "enhanced" driver allows any text to contain the following special
  3285.  formatting instructions (e.g., use the `set format` command to put them in
  3286.  for axis scales):
  3287.  
  3288.   Control      Examples        Explanation
  3289.    ^           a^x             superscript
  3290.    _           a_x             subscript
  3291.    @           @x or a@^b_c    phantom box (occupies no width)
  3292.  
  3293.  {text} can be used to allow multiple-character text, where only a single
  3294.  character is expected (e.g., 2^{10}).  To change the font and/or size, use
  3295.  the full form:  {/[fontname][=fontsize] text}   (For example, {/Symbol=20 G}
  3296.  is a 20 point GAMMA).  (The '/' character MUST be the first character after
  3297.  the '{'.)
  3298.  
  3299.  The phantom box is useful for a@^b_c to align superscripts and subscripts,
  3300.  and for overwriting an accent on a letter.  It is common sense to put the
  3301.  shorter of the two in the phantom box.
  3302.  
  3303.  You can access special symbols numerically by specifying \character-code (in
  3304.  octal), e.g., {/Symbol \245} is infinity.
  3305.  
  3306.  You can escape control characters using \, e.g.,  \\, \{, \}, \^, \@.
  3307. ?set terminal pslatex
  3308. ?pslatex
  3309.  There are a few options for the pslatex driver.
  3310.  
  3311.  Syntax:
  3312.          set terminal pslatex {<color>} {<rotate>} {auxfile}
  3313.  
  3314.  <color> is either `color` or `monochrome`.  If `default` is specified, the
  3315.  plot will have rotated text and be in monochrome, all in one file.  <rotate>
  3316.  is either `rotate` or `norotate` and determines if the vertical axis label
  3317.  is rotated.
  3318.  
  3319.  If `auxfile` is specified, it directs the driver to put the PostScript
  3320.  commands into an auxiliary file instead of directly into the LaTeX file.
  3321.  This is useful if your plots are large, and dvips cannot handle the picture.
  3322.  The PostScript file name for this option is determined by replacing the
  3323.  trailing `.tex` with `.ps` in the output file name.
  3324.  
  3325.  Example:
  3326.          set term pslatex auxfile    # put PostScript parts in file foo.ps
  3327.          set output "foo.tex"
  3328. ?set terminal fig
  3329. ?fig
  3330.  The `fig` terminal device has the options of either color or  monochrome
  3331.  and small or large image.  The default is monochrome and small.
  3332.  To select color, use:
  3333.         set terminal fig color
  3334.  To select large, use:
  3335.         set terminal fig large
  3336.  The large option is a substitute for the `bfig` terminal in earlier version,
  3337.  which is no longer supported.
  3338. ?set terminal regis
  3339. ?table
  3340.  The `regis` terminal device has the option of using 4 or 16 colors.  The
  3341.  default is 4.  For example:
  3342.         set term regis 16
  3343. ?set terminal table
  3344. ?table
  3345.  Instead of producing a picture, the `table` terminal prints out evaluation
  3346.  results in a multicolumn ASCII table of X Y Z values.  For those times when
  3347.  you really want to see the numbers, now you can see them on the screen or
  3348.  save to a file.  This can be useful if you want to use the contouring engine
  3349.  of `gnuplot` to work out the contours of your data.  See `set contour` for an
  3350.  example.  The same trick can be used to output gridded data (`set dgrid3d`).
  3351. ?set terminal tgif
  3352. ?tgif
  3353.  The Tgif driver supports different pointsizes (with `set pointsize`),
  3354.  different label fonts and font sizes (in, e.g. `set label "Hallo" at x,y
  3355.  font "Helvetica,34"`) and multiple plots on the page.  The proportions of
  3356.  the axes are not changed.
  3357.  
  3358.  Syntax:
  3359.          set terminal tgif {<mode>} {<[x,y]>} {<dashed>} \
  3360.                            {"<fontname>"} {<fontsize>}
  3361.  
  3362.  where <mode> is `portrait` or `landscape`, <[x,y]> specify the number of
  3363.  plots in the x and y directions on the page, <dashed> is either `solid` or
  3364.  `dashed`, "<fontname>" is the name of a valid PostScript font, and <fontsize>
  3365.  specifies the size of the PostScript font.
  3366.  
  3367.  Examples:
  3368.          set term tgif                  # -> one plot,portrait
  3369.          set term tgif landscape        # -> one plot,landscape
  3370.          set term tgif portrait [2,4]   # -> 2 plots in x and 4 in y-direction
  3371.          set term tgif [1,2]            # -> 1 plot  in x and 2 in y-direction
  3372. ?set terminal uniplex
  3373. ?uniplex
  3374.  The uniplex driver is able to combine several plots in one image.  The option
  3375.  portrait causes the image to be drawn in a window where the width is about
  3376.  2/3 of the height (default is landscape---the image height is about 2/3 of
  3377.  the width).  The fontsize may also be specified (sizes 1--8).  Only one image
  3378.  is allowed per file.  If an 'X' is included in the `set output` filename, the
  3379.  'X' is replaced by a sequential plot number.
  3380.  
  3381.  Options are:
  3382.        portrait
  3383.        landscape        (default)
  3384.        [ x , y ]        (where x and y are the number of plots in the x and y
  3385.                          directions of the image)
  3386.        n                (where n is fontsize (1--8))
  3387.  
  3388.  To plot 6 plots in one image in two columns in portrait orientation:
  3389.        set term uniplex po [2,3]
  3390. ?set terminal windows
  3391. ?windows
  3392.  Three options may be set in the windows driver.
  3393.  
  3394.  Syntax:
  3395.          set terminal windows {<color>} {"<fontname>"} {<fontsize>}
  3396.  
  3397.  `<color>` is either `color` or `monochrome`, `"<fontname>"` is the name of a
  3398.  valid Windows font, and `<fontsize>` is the size of the font in points.
  3399. ?set terminal windows graph-menu
  3400. ?graph-menu
  3401.  The `gnuplot graph` window has the following options on a pop-up menu
  3402.  accessed by pressing the right mouse button or selecting `Options` from the
  3403.  system menu:
  3404.  
  3405.  `Bring to Top` when checked brings the graph window to the top after every
  3406.  plot.
  3407.  
  3408.  `Color` when checked enables color linestyles.  When unchecked it forces
  3409.  monochrome linestyles.
  3410.  
  3411.  `Copy to Clipboard` copies a bitmap and a Metafile picture.
  3412.  
  3413.  `Background...` sets the window background color.
  3414.  
  3415.  `Choose Font...` selects the font used in the graphics window.
  3416.  
  3417.  `Line Styles...` allows customization of the line colors and styles.
  3418.  
  3419.  `Print...` prints the graphics windows using a Windows printer driver and
  3420.  allows selection of the printer and scaling of the output.  The output
  3421.  produced by `Print` is not as good as that from `gnuplot`'s own printer
  3422.  drivers.
  3423.  
  3424.  `Update wgnuplot.ini` saves the current window locations, window sizes, text
  3425.  window font, text window font size, graph window font, graph window font
  3426.  size, background color and linestyles to the initialization file
  3427.  `WGNUPLOT.INI`.
  3428. ?set terminal windows printing
  3429. ?printing
  3430.  In order of preference, graphs may be be printed in the following ways.
  3431.  
  3432.  `1.` Use the `gnuplot` command `set terminal` to select a printer and `set
  3433.  output` to redirect output to a file.
  3434.  
  3435.  `2.` Select the `Print...` command from the `gnuplot graph` window.  An extra
  3436.  command `screendump` does this from the text window.
  3437.  
  3438.  `3.` If `set output "PRN"` is used, output will go to a temporary file.  When
  3439.  you exit from `gnuplot` or when you change the output with another `set
  3440.  output` command, a dialog box will appear for you to select a printer port.
  3441.  If you choose OK, the output will be printed on the selected port, passing
  3442.  unmodified through the print manager.  It is possible to accidentally (or
  3443.  deliberately) send printer output meant for one printer to an incompatible
  3444.  printer.
  3445. ?set terminal windows text-menu
  3446. ?text-menu
  3447.  The `gnuplot text` window has the following options on a pop-up menu accessed
  3448.  by pressing the right mouse button or selecting `Options` from the system
  3449.  menu:
  3450.  
  3451.  `Copy to Clipboard` copies marked text to the clipboard.
  3452.  
  3453.  `Paste` copies text from the clipboard as if typed by the user.
  3454.  
  3455.  `Choose Font...` selects the font used in the text window.
  3456.  
  3457.  `System Colors` when selected makes the text window honor the System Colors
  3458.  set using the Control Panel.  When unselected, text is black or blue on a
  3459.  white background.
  3460.  
  3461.  `Update wgnuplot.ini` saves the current text window location, text window
  3462.  size, text window font and text window font size to the initialisation file
  3463.  `WGNUPLOT.INI`.
  3464.  
  3465.  `MENU BAR`
  3466.  
  3467.  If the menu file `WGNUPLOT.MNU` is found in the same directory as
  3468.  WGNUPLOT.EXE, then the menu specified in `WGNUPLOT.MNU` will be loaded.
  3469.  
  3470.  Menu commands are:
  3471.    [Menu]       Start a new menu with the name on the following line
  3472.    [EndMenu]    End current menu.
  3473.    --           Insert a horizontal menu separator
  3474.    |            Insert a vertical menu separator
  3475.    [Button]     Put next macro on a push button instead of a menu.
  3476.  
  3477.  Macros take two lines with the macro name (menu entry) on the first line and
  3478.  the macro on the second line.  Leading spaces are ignored.
  3479.  
  3480.  Macros commands are:
  3481.    [INPUT]      Input string with prompt terminated by [EOS] or {ENTER}
  3482.    [EOS]        End Of String terminator.  Generates no output.
  3483.    [OPEN]       Get name of file to open from list box, with title of list box
  3484.                 terminated by [EOS], followed by default filename terminated
  3485.                 by [EOS] or {ENTER}.  This uses COMMDLG.DLL from Windows 3.1.
  3486.    [SAVE]       Get name of file to save.  Similar to [OPEN]
  3487.  
  3488.  Macros character substitutions are:
  3489.    {ENTER}      Carriage Return '\r'
  3490.    {TAB}        Tab     '\011'
  3491.    {ESC}        Escape  '\033'
  3492.    {^A}         '\001'
  3493.    ...
  3494.    {^_}         '\031'
  3495.  
  3496.  Macros are limited to 256 characters after expansion.
  3497. ?set terminal windows wgnuplot.ini
  3498. ?wgnuplot.ini
  3499.  Windows `gnuplot` will read some of its options from the `[WGNUPLOT]` section
  3500.  of `WGNUPLOT.INI` in the Windows directory.  An example `WGNUPLOT.INI` file
  3501.  is shown below.
  3502.  
  3503.   [WGNUPLOT]
  3504.   TextOrigin=0 0
  3505.   TextSize=640 150
  3506.   TextFont=Terminal,9
  3507.   GraphOrigin=0 150
  3508.   GraphSize=640 330
  3509.   GraphFont=Arial,10
  3510.   GraphColor=1
  3511.   GraphToTop=1
  3512.   GraphBackground=255 255 255
  3513.   Border=0 0 0 0 0
  3514.   Axis=192 192 192 2 2
  3515.   Line1=0 0 255 0 0
  3516.   Line2=0 255 0 0 1
  3517.   Line3=255 0 0 0 2
  3518.   Line4=255 0 255 0 3
  3519.   Line5=0 0 128 0 4
  3520.  
  3521.  The `GraphFont` entry specifies the font name and size in points.  The five
  3522.  numbers given in the `Border`, `Axis` and `Line` entries are the `Red`
  3523.  intensity (0--255), `Green` intensity, `Blue` intensity, `Color Linestyle`
  3524.  and `Mono Linestyle`.  `Linestyles` are 0=SOLID, 1=DASH, 2=DOT, 3=DASHDOT,
  3525.  4=DASHDOTDOT.  In the example `WGNUPLOT.INI` file above, Line 2 is a green
  3526.  solid line in color mode, or a dashed line in monochrome mode.  The default
  3527.  line width is 1 pixel.  If `Linestyle` is negative, it specifies the width of
  3528.  a SOLID line in pixels.  Line1 and any linestyle used with the `points` style
  3529.  must be SOLID with unit width.
  3530. ?set terminal windows windows3.0
  3531. ?windows3.0
  3532.  Windows 3.1 is preferred, but WGNUPLOT will run under Windows 3.0 with the
  3533.  following restrictions:
  3534.  
  3535.  `1.` COMMDLG.DLL and SHELL.DLL (available with Windows 3.1 or Borland C++
  3536.  3.1) must be in the windows directory.
  3537.  
  3538.  `2.` WGNUPLOT.HLP produced by Borland C++ 3.1 is in Windows 3.1 format.
  3539.  You need to use the WINHELP.EXE supplied with Borland C++ 3.1.
  3540.  
  3541.  `3.` It won't run in real mode due to lack of memory.
  3542.  
  3543.  `4.` TrueType fonts are not available in the graph window.
  3544.  
  3545.  `5.` Drag-drop does not work.
  3546. ?set tics
  3547. ?show tics
  3548. ?tics
  3549.  The `set tics` command can be used to change the tics to be drawn outwards.
  3550.  
  3551.  Syntax:
  3552.          set tics {<direction>}
  3553.          show tics
  3554.  
  3555.  where <direction> may be `in` or `out`.  `set tics` defaults to `in`.  `show
  3556.  tics` displays a lot of information about the tics.
  3557.  
  3558.  It is now necessary to do
  3559.    set xtics nomirror ; set ytics nomirror
  3560.  in order to switch off the duplicate tics on top and right borders.  This is
  3561.  useful when doing impulse plots.
  3562.  
  3563.  See also the `set xtics`, `set ytics`, and `set ztics` commands for more
  3564.  control of tic marks and `set mxtics`, `set mytics`, and `set mztics` for
  3565.  minor tic marks.
  3566. ?set ticslevel
  3567. ?show ticslevel
  3568. ?ticslevel
  3569.  Using `splot`, one can adjust the relative height of the vertical (Z) axis
  3570.  using `set ticslevel`.  The numeric argument provided specifies the location
  3571.  of the bottom of the scale.  A zero will put it on the bottom grid and any
  3572.  positive number somewhere along the z axis.
  3573.  
  3574.  Syntax:
  3575.          set ticslevel {<level>}
  3576.          show tics
  3577.  
  3578.  where <level> is a non-negative numeric argument.  For example,
  3579.  
  3580.          set ticslevel 0.5
  3581.  
  3582.  sets the tics level to the default value.
  3583.  
  3584.  See also `set view`.
  3585. ?set ticscale
  3586. ?ticscale
  3587.  The size of the tic marks can be adjusted with `set ticscale`.
  3588.  
  3589.  Syntax:
  3590.          set ticscale {<major> {<minor>}}
  3591.          show tics
  3592.  
  3593.  If <minor> is not specified, it is 0.5*<major>.  The default size is 1.0 for
  3594.  major tics and 0.5 for minor tics.  Note that it is possible to have the tic
  3595.  marks pointing outward by specifying a negative size.
  3596. ?set time
  3597. ?show time
  3598. ?time
  3599.  The optional `set time` places the time and date of the plot either at the
  3600.  top or bottom of the left margin.  The exact location is device dependent.
  3601.  
  3602.  Syntax:
  3603.          set time {<xoff>}{,<yoff>}
  3604.          set notime
  3605.          show time
  3606.  
  3607.  Specifying constants <xoff> or <yoff> as optional offsets for the time will
  3608.  move the time <xoff> or <yoff> character-screen co-ordinates.  For example,
  3609.  
  3610.          set time ,-3
  3611.  
  3612.  will change only the y offset of the time, moving the title down by roughly
  3613.  the height of three characters.
  3614. ?set timefmt
  3615. ?show timefmt
  3616. ?timefmt
  3617.  This command applies to timeseries where data are composed of dates/times.
  3618.  It has no meaning unless the command `set {x,y,z}data time` is given also.
  3619.  The string argument tells `gnuplot` how to read timedata from the datafile.
  3620.  Valid conversion codes are: %d (day of month,1--31), %m (month,1--12), %y
  3621.  (year,0--99), %Y (year, 4 digits), %j (day of year,1--365), %H (hour,0--24),
  3622.  %M (minute,0--60), %S (second,0--60).  Any character is allowed in the string
  3623.  (including space), but must match exactly.  Backslash-octals (\nnn) are
  3624.  converted to char; \t (tab) is understood.  If there is no separating
  3625.  character between the date/time elements, then %d, %m, %y, %H, %M and %S read
  3626.  two digits each, %Y reads four digits and %j reads three digits.  Each column
  3627.  in the timedata counts as one column in the `using n:n` specification.
  3628.  
  3629.  Syntax:
  3630.          set timefmt "<format string>"
  3631.          show timefmt
  3632.  
  3633.  See also `set {x,y,z}data`.
  3634.  
  3635.  Example:
  3636.          set timefmt "%d/%m/%Y\t%H:%M"
  3637.  tells `gnuplot` to read date and time separated by tab.
  3638. ?set title
  3639. ?show title
  3640. ?title
  3641.  The `set title` command produces a plot title that is centered at the top of
  3642.  the plot.  `set title` is a special case of `set label`.
  3643.  
  3644.  Syntax:
  3645.           set title {"<title-text>"} {<xoff>}{,<yoff>}
  3646.           show title
  3647.  
  3648.  Specifying constants <xoff> or <yoff> as optional offsets for the title will
  3649.  move the title <xoff> or <yoff> character screen co-ordinates (not plot
  3650.  co-ordinates).  For example,
  3651.  
  3652.           set title ,-1
  3653.  
  3654.  will change only the y offset of the title, moving the title down by
  3655.  roughly the height of one character.
  3656.  
  3657.  `set title` with no parameters clears the title.
  3658.  
  3659.  See `set syntax` for details about the processing of backslash sequences and
  3660.  the distinction between single- and double-quotes.
  3661.  The command `set tmargin` sets the size of the top margin.  Please see
  3662.  `set margins` for details.
  3663.  The `set trange` command sets the parametric range used to compute x and y
  3664.  values when in parametric or polar modes.  Please see `set xrange` for
  3665.  details.
  3666.  The `set urange` and `set vrange` commands set the parametric ranges used
  3667.  to compute x, y, and z values when in `splot` parametric mode.  Please see
  3668.  `set xrange` for details.
  3669. ?show variables
  3670.  The `show variables` command lists all user-defined variables and their
  3671.  values.
  3672.  
  3673.  Syntax:
  3674.          show variables
  3675. ?set view
  3676. ?show view
  3677. ?view
  3678.  The `set view` command sets the viewing angle for `splot`s.  It controls how
  3679.  the 3-d co-ordinates of the plot are mapped into the 2-d screen space.  It
  3680.  provides controls for both rotation and scaling of the plotted data, but
  3681.  supports orthographic projections only.
  3682.  
  3683.  Syntax:
  3684.          set view <rot_x> {,{<rot_z>}{,{<scale>}{,<scale_z>}}}
  3685.          show view
  3686.  
  3687.  where <rot_x> and <rot_z> control the rotation angles (in degrees) along a
  3688.  virtual 3-d co-ordinate system aligned with the screen such that the screen
  3689.  horizontal axis is x, screen vertical axis is y, and the axis perpendicular
  3690.  to the screen is z.  <rot_x> is bounded to the [0:180] range with a default
  3691.  of 60 degrees, while <rot_z> is bounded to the [0:360] range with a default
  3692.  of 30 degrees.  <scale> controls the scaling of the entire `splot`, while
  3693.  <scale_z> scales the z axis only.  Both scales default to 1.0.
  3694.  
  3695.  Examples:
  3696.          set view 60, 30, 1, 1
  3697.          set view ,,0.5
  3698.  
  3699.  The first sets all the four default values.  The second changes only scale,
  3700.  to 0.5.
  3701.  
  3702.  See also `set ticslevel`.
  3703.  The `set urange` and `set vrange` commands set the parametric ranges used
  3704.  to compute x, y, and z values when in `splot` parametric mode.  Please see
  3705.  `set xrange` for details.
  3706.  Sets x2-axis data to timeseries (dates/times).  Please see `set xdata`.
  3707.  The `set x2dtics` command changes tics on the x2 axis to days of the week.
  3708.  Please see `set xmtics` for details.
  3709.  This command sets the label for the x2 axis.  Please see `set xlabel`.
  3710.  The `set x2mtics` command changes tics on the x2 axis to months of the year.
  3711.  Please see `set xmtics` for details.
  3712.  The `set x2range` command sets the horizontal range that will be displayed
  3713.  on the x2 (top) axis.  PLease see `set xrange` for details.
  3714.  The `set x2tics` command controls major (labelled) tics on the x2 axis.
  3715.  Please see `set xtics` for details.
  3716.  The `set x2zeroaxis` command draws a line at x2 = 0.  For details, please see
  3717.  `set zeroaxis`.
  3718. ?set xdata
  3719. ?show xdata
  3720. ?xdata
  3721.  This command sets the datatype on the x axis to date/time.  A similar command
  3722.  does the same thing for each of the other axes.
  3723.  
  3724.  Syntax:
  3725.          set xdata time
  3726.          set ydata time
  3727.          set zdata time
  3728.          set x2data time
  3729.          set y2data time
  3730.  
  3731.  To turn the x axis data back to the default:
  3732.          set xdata
  3733.  
  3734.  See `set timefmt` to tell `gnuplot` how to read date or time data.  The
  3735.  date/time is converted to seconds from start of the century.  There is
  3736.  currently only one timefmt, which implies that all the date/time columns must
  3737.  confirm to this format.  Specification of ranges should be supplied as quoted
  3738.  strings according to this format to avoid interpretation of the date/time as
  3739.  an expression.
  3740.  
  3741.  The function "strftime" (type "man strftime" on unix to look it up) is used
  3742.  to print ticmark labels.  `gnuplot` tries to figure out a reasonable format
  3743.  for this  unless the `set format x "string"` has supplied something that does
  3744.  not look like a decimal format (more than one '%' or neither %f nor %g).
  3745. ?set xdtics
  3746. ?set noxdtics
  3747. ?show xdtics
  3748. ?xdtics
  3749. ?noxdtics
  3750. ?set ydtics
  3751. ?set noydtics
  3752. ?show ydtics
  3753. ?ydtics
  3754. ?noydtics
  3755. ?set zdtics
  3756. ?set nozdtics
  3757. ?show zdtics
  3758. ?zdtics
  3759. ?nozdtics
  3760. ?set x2dtics
  3761. ?set nox2dtics
  3762. ?show x2dtics
  3763. ?x2dtics
  3764. ?nox2dtics
  3765. ?set y2dtics
  3766. ?set noy2dtics
  3767. ?show y2dtics
  3768. ?y2dtics
  3769. ?noy2dtics
  3770.  The `set xdtics` commands converts the x-axis tic marks to days of the week
  3771.  where 0=Sun and 6=Sat.  Overflows are converted modulo 7 to dates.  `set
  3772.  noxdtics` returns the labels to their default values.  Similar commands do
  3773.  the same things for the other axes.
  3774.  
  3775.  Syntax:
  3776.         set xdtics
  3777.         set ydtics
  3778.         set zdtics
  3779.         set x2dtics
  3780.         set y2dtics
  3781.         set noxdtics
  3782.         etc.
  3783.         show xdtics
  3784.         etc.
  3785.  
  3786.  See also the `set format` command.
  3787. ?set xlabel
  3788. ?show xlabel
  3789. ?xlabel
  3790. ?set ylabel
  3791. ?show ylabel
  3792. ?ylabel
  3793. ?set zlabel
  3794. ?show zlabel
  3795. ?zlabel
  3796. ?set x2label
  3797. ?show x2label
  3798. ?x2label
  3799. ?set y2label
  3800. ?show y2label
  3801. ?y2label
  3802.  The `set xlabel` command sets the x axis label.  Similar commands set labels
  3803.  on the other axes.  There is no explicit `set x2label` command---use `set
  3804.  title` (see below).
  3805.  
  3806.  Syntax:
  3807.           set xlabel {"<label>"} {<xoff>}{,<yoff>}
  3808.           set ylabel {"<label>"} {<xoff>}{,<yoff>}
  3809.           set zlabel {"<label>"} {<xoff>}{,<yoff>}
  3810.           set y2label {"<label>"} {<xoff>}{,<yoff>}
  3811.           show xlabel
  3812.           etc.
  3813.  
  3814.  Specifying the constants <xoff> or <yoff> as optional offsets for a label
  3815.  will move it <xoff> or <yoff> character screen co-ordinates.  For example,
  3816.  
  3817.           set xlabel -1
  3818.  
  3819.  will change only the x offset of the xlabel, moving the label roughly one
  3820.  character width to the left.
  3821.  
  3822.  To clear the label, put no options on the command line.  For example,
  3823.  
  3824.           set y2label
  3825.  
  3826.  The default positions of the axis labels are as follows:
  3827.  
  3828.  xlabel:  The x-axis label is centered below the bottom a push btom ahclg set ssse oumust be ametriticsca
  3829. ook l font, anl run un, %Y r         ns o1.nclhe `set x to thver
  3830.  solitheduces a plolithetrols for bmmanust be ently 
  3831. l if youines it window thet
  3832.  execuin Win sma fooond l2. Vreen
  3833.  ho windows:
  3834.  
  3835.  xlcreen
  3836.  hhe METAFONTithetrols for bmmanust be ently 
  3837. l ifuines it window thet
  3838.  execuin Win sma fooond l3.nclhe `set x to tows:
  3839.  
  3840.  xlcreen
  3841.  hhe METAFONTithetrols for bmmans fEE
  3842.  tluey fileetriT
  3843.  tits per pin Win sma fooonmans frn Ro the ital mehe `sbs. kative hei\\ime" oevter is.
  3844. >"} {<x
  3845.  datperscripts als for bmmanoitle
  3846. ?tie rotreen
  3847.  horl: 
  3848.  inwn by rou,ariei\\ilash seqs theWGNUPLOT.label, movi(.  Thes fran sgiblnd lz centerns fzels are as follows:
  3849.  
  3850.  xl and any
  3851.  positiMIF Frat outd,0--60)paractch pro--60.  A scaleel is2 centerns fy2els are as follrat out label rlot`, one cayhis commaot` hlow the bishort desc-rgin.  Thhe menu file thenilarsvalid Wi push btom ael ix2 centerns  set labee other axes.  There rted te to a file.plabele as fd.  T controls ecial
  3852.  for'hly the h'ear the lght ofew-les...'\031'
  3853.  
  3854.  M"\n `dETAFot plot
  3855.  co-ordinates)."d of diret title`\n\nd of diret ter axes"t pmajor ticsthe dition osith Windostrfel ior (labelled) timeters clearfurimilan`.  `show
  3856.  tics` for detail `set synt
  3857. xis is x,pointsizceslash sequences and
  3858.  the distinctdranges s
  3859.  
  3860.  See amow zdtics
  3861. ?zdmcs
  3862. ?nozdticsmcs
  3863. ?nosmcs
  3864. ?no?zdmcs
  3865. ?nozand mow zdtics
  3866. ?zymcs
  3867. ?nozdticymcs
  3868. ?noymcs
  3869. ?no?z mow zdtics
  3870. zmow zdtics
  3871. ?zzmcs
  3872. ?nozdticzmcs
  3873. ?nozmcs
  3874. ?no?zzmow zdtics
  3875.  Pleasedtics
  3876. ?zdtmcs
  3877. ?nozdticstmcs
  3878. ?nostmcs
  3879. ?no?zdtmcs
  3880. ?nozand lmow zdtics
  3881. ?zytmcs
  3882. ?nozdticytmcs
  3883. ?noytmcs
  3884. ?no?zytmcs
  3885. ?n?set y2labemics
  3886. ?y2dtics
  3887. ?noy2dtics
  3888.  The `set xdtics` commanmand changes 
  3889. tics -axis t1=Jaarks t1  `ecs of the week
  3890.  where 0=Sun and 6=S12mmanmand c
  3891.  Pleas The dre moduloout label noxdtics` 
  3892.  The df thics
  3893. ?zdmcs
  3894. ?`label` comcts the drien .  `menu file ducriptimilar commands do
  3895.  thnly.  Both scales See amow zd the command mow zd the commandzmcs
  3896.         set ydtimow zd the command imow zd the command?zdmcs
  3897. ?n>}{,<yoff>}
  3898.  bel {"<label>"moxdtics
  3899.         etc.
  3900.         show xdtics
  3901.         etc.
  3902.  
  3903.  See am to nozdticsm to noam to nozand m to nozdtic m to noym to nozandzm to nozdticzm to nozm to nozand`set xmnozdticstm to noa2m to nozand set xmnozdtic set xmnoy2m to nozandret xmnozdticret xmnorm to nozandtet xmnozdtictet xmnotm to nozanduet xmnozdticuet xmnoum to nozandvet xmnozdticvet xmnovet xmn?set y2labeet xmtics` for details.
  3904.  The `set x2range` command sets the horpk datype on the x al goss <xoffar command
  3905.  does the s,arsvwet primimilar 
  3906.  and y
  3907. rd
  3908.  erar the
  3909.  fontx, y, and les` commarintametrivame thing for each of the 2range[tax:
  3910. > :> {ax>}]or each of the 2range[tax:
  3911. > :> {ax>}]or each of thez2range[tax:
  3912. > :> {ax>}]or each of the 22range[tax:
  3913. > :> {ax>}]or each of they22range[tax:
  3914. > :> {ax>}]or each of ther2range[tax:
  3915. > :> {ax>}]or each of thet2range[tax:
  3916. > :> {ax>}]or each of theu2range[tax:
  3917. > :> {ax>}]or each of thev2range[tax:
  3918. > :> {ax>}]o        {":
  3919.     {ax>hort ek
  3920.  where
  3921.       t no pretatioss a gre/tie data 
  3922. laurma 30 derted to c command armat to ao on..th Wie coabel rrangea.
  3923.  Tion of ranges hould be suppliethe default:
  3924.    /time col <scaieth{":
  3925.     {ax>
  3926. hort ek
  3927.  whg the co%M (minretur 
  3928.   te sizet p youbeThe proporti, 2tesontxee also `setyee alsoScript fies.  <("Ent set y2lab s,a`set mar
  3929. is either `rbel rrangetrols fox, y, and les` comused to compute++ 3.milar 
  3930.  rrangetrols f`set vry spd y
  3931.  vallabel` com an ad to compute3esontxee alsluetyee alsmarks azee alsogpersnt y2lab sarks aSee also `setvee alsogpersnt y2
  3932. ntx, y, and les` commASH, 2spd y
  3933.  val,`ree alsoScript fi`rbel rrth a et xmn?curvetyps pe":
  3934. c.  Eacvel
  3935. ?dt it oere
  3936.     t label rd
  3937.  ersed to Eacpe"ax>
  3938. h
  3939. c.  Eacvoard.t label rd
  3940.  eris f onr exaght ord
  3941.  era:36and prt lope"ax>f> as ob <curvetype>
  3942.  (minrrange      spslai hhe milao managaurma 30how alfooecteite     you EPS on accent aurma 30hle
  3943.  x, y, and les` comu out a  and 0.r both ght o `gnurtiR to tht 2/3 of
  3944.  the width). ssse ou` following wayabel, pAnrrangee commd.  T coof the grmmand setas continu com
  3945.  Each ` following wa;belsrangee commof tahe de`ear the lghnd setas continnly imililenamre n is ticsth}
  3946.          ime, m noset m to t.  See `set  plach,modview` comman
  3947.  thnly.  Both se:
  3948.  r is.
  3949.  2rangetime
  3950.  
  3951.  To turn the x axis data2range[-1n i0]h se:
  3952.  r is.
  3953. y2rangetimof r (labfsetd to  the x axis daty2range[1n -i0]h se:le,
  3954.  
  3955.   z"axhe z t WGNU labeintssing z":
  3956. f the ist 2/ipt commeaurma 30ho):or each of thez2range[ i0]h se:aurma 30hlx":
  3957. fange wr ( onlyx"axhked  prop the x axis data2range[*:ion:
  3958.   xeasedtics
  3959. ?zdcs
  3960. ?nozdticscs
  3961. ?noscs
  3962. ?no?zdcs
  3963. ?nozand ow zdtics
  3964. ?zycs
  3965. ?nozdticycs
  3966. ?noycs
  3967. ?no?zyow zdtics
  3968. zow zdtics
  3969. ?zzcs
  3970. ?nozdticzcs
  3971. ?nozcs
  3972. ?no?zzow zdtics
  3973.  Peasedtics
  3974. ?zdtcs
  3975. ?nozdticstcs
  3976. ?nostcs
  3977. ?no?zdtcs
  3978. ?nozand low zdtics
  3979. ?zytcs
  3980. ?nozdticytcs
  3981. ?noytcs
  3982. ?no?zytoxdticFes...`nd `set zthe.
  3983.  The `set x2tics` command conorizontal.5 for miWGNUPLOT wd) tics on t There rteleas The       sduloout ytixels.  Linics
  3984. ?zdcs
  3985. ?`
  3986. he output wget E    sduloout nput ot specifiees i)ize of the xcs
  3987. ?`label` comcts the driow view
  3988.  
  3989.  whjor>.  The abel.  Similar command---use `set
  3990.  title` (s The {rizon| the duf>}{no}   setal tgif {<mode>} {<[x,y]>}{>}
  3991. e/tim>n tof r>rol<n. _x> |tgif {<mode>} {<[x,y]>}{(ff>}{,<yoff><.5 .
  3992.  
  3993.   ff>}{,<yoff><.5 .}e  )}  zlabel {"<label> The (`set  left.
  3994. )ylabel {"<label> The (`set  left.
  3995. )ylabel {"<labeldtcs
  3996. ? (`set  left.
  3997. )ylabel {"<labelytcs
  3998. ? (`set  left.
  3999. )ylabel {"<label?zdcs
  4000. ?nlabel {"<lf>}
  4001.  bel {"<l<label>"cs
  4002. ?nlabel {"<lf>}
  4003.   wdxtics`ew` the du`      set timefmt "%ps` displaysi(.<scaiethlaysiietms. `ss
  4004. xis is x,ouldputn show
  4005.  The )l and any
  4006.  lot`, r  The xe du,nderwher cosuppe>}  set`      sifile.plab ouet x2tis The dtmenu file           snt y2
  4007. nop     he xe dulowso
  4008.    setndow.  wticsmmandes. (typow.  is not specifsch exa the du    setndf>.  The abel.   paramx2t wgetyhis ulticolumn 
  4009.  positincluded  Lin{rizo|the duf`   set termf memory.
  4010.  
  4011.  `4is is x,pwidth is aso
  4012.    setnear for yoth} a file. now nets fzels ar Theo on..tlot`, a file.c36andstylesytics`,rodatimilar mize of the the du`n of the          set y2l The       sory as
  4013.  WGNUPcimal fset en /tim ns o the
  4014. e/tim>n tof r>ol<n. _ /timvel`.  The nuy on  detailt zticslghnd sen?curvety abel.  ls arf there is nranges 
  4015. e/tim> 
  4016.     n. _ plot` omof r mEnt se
  4017.  tof r>rted t n. _ ermf mee comw tics
  4018.  
  4019. l btimdme
  4020.  linen
  4021.  octalis notof r mEnt
  4022.        sks pointtimefmt
  4023.  
  4024.  See also `setle` (s The 0,.5 Grapow.
  4025.  
  4026.  `The dtm
  4027.  
  4028.   Th
  4029.  ExamTh
  4030.  e  , 9Th
  4031.  E0n of the(f>}{,<yof><.5 .
  4032.  e  ) /timv-Roman" rles` is dtic          sr      
  4033.  
  4034.  whe `setook it up)A abel -1
  4035. The  the tbel -1         ,far coplot`Windobe u the co
  4036. `set xlabmajor tics the x off the ttuseful clowing opion ost wget E    sthe `e
  4037.     tttusef,inate Eac"he fonis a enhancedt to contain .  `show
  4038.  imilar 
  4039.  seton the b(bfig` terenu file xt-menu        ),inate Eac"%3foardchar"o work
  4040. w xdtics
  4041.      et yticsin`.  `show
  4042.  tics` din thes, or a d x off E    smeciyou  [an access speciait Eacvelu  [anttusefrted tt (ttusefu the comncludedxdtics` 
  4043.  The<yo.
  4044.  
  4045.  You "man strfASH, 2=Dd as qu,t y2l The th}
  4046.     3.1 is b is jsof prefo.
  4047.  
  4048.  You cs nomis only.  Both scales dle` (s The ("oma"m
  4049.  
  4050.  "ize 2," 5
  4051.  
  4052.  "ot i en00)h scales dle` (s The (y-d,4,8,16,32,64,2
  4053.  ,   ,512 Grj (zlabel {"<label> The (" x-axi"m
  4054.  
  4055.  " en0
  4056.  " pl"  ()rti, 2enu f all t/[fontnamnly oThe dre uet x2tiASH, 2=DOT=Ddr
  4057.  
  4058.  `       se procThe dre uet x2tiA of icslghnd `    b <curvety used
  4059.  to2rangnd liis 1.( ouet x2tics` comticscale
  4060. des text fr xdtimcs on t There rrti, 2the plot for detailrotatilow the branges th Windoe commaation of Overf
  4061. ` to telshould be supplieth that d`ault:
  4062.   
  4063.  Please see set xtics` for details.
  4064.  The `set xzeroaxis` command draws a line at x2 = 0.  For dease sye
  4065.  `set xrange` for details.
  4066.  Sets x2-axis data to timeseries (dates/times).y Please see `set xdata`.
  4067.  The `set xydtics` command changes tics on the x2 axis to days of the week.
  4068.  Please see `set xmtics` for details.
  4069.  yhis command sets the label for the x2 axis. yPlease see `set xlabel`.
  4070.  The `set xymtics` command changes tics on the x2 axis to months of the year.
  4071.  Please see yset xmtics` for details.
  4072. treen
  4073.  horrange` command sets the hormd.  T coyhis command sets the labelhe x2 (top) axis.  PLease see yset xrange` for details.
  4074.  The `set x2tics` command coytrols major (labelled) tics on the x2 axis.
  4075.  Please seey`set xtics` for details.
  4076.  The `set y2zeroaxis` command draws a line at x2 = 0.  For dease sy
  4077.  `set xrange` for details.
  4078.  Sets x2-axis data to timeseries (dates/times).yPlease see `set xdata`.
  4079.  The `set xytics` command changes tics on the x2 axis to days of the week.
  4080.  Please see `set xmtics` for details.
  4081.  yis command sets the label for the x2 axis. ymlease see `set xdata`.
  4082.  The `set xytics` command changes tics on the x2 axis to months of the year.
  4083.  Please see yet xmtics` for details.
  4084. treen
  4085.  horrange` command sets the hormd.  T coyis command sets the labelhe x2 (top) axis.  PLease see yet xrange` for details.
  4086.  The `set x2tics` command coyrols major (labelled) tics on the x2 axis.
  4087.  Please seeyset xtics` for details.
  4088.  The `set yzeroaxis` command draws a line at x2 = 0.  For dease z `set xrenge` for details.
  4089.  Sets x2-axis data to timeseries (dates/times).zPlease see `set xdata`.
  4090.  The `set xztics` command changes tics on the x2 axis to days of the week.
  4091.  P? x2 = 0.nozdticz 0.noz 0.nes/timz 0.`nretur terenu cales the %Ys plaf theranges e 30. cormat0axis othing for each of theion
  4092.  <o pretatio>{,{<rot_z>}{,{<z 0.n
  4093.  wgnuplot.ini
  4094. ?woff> cha wind exai
  4095.  Windze (desheWGtimeira:36and pine agoctudded  asse ou`z 0.`ne %Ys pla.ound=2rm to th if younu st a reass`z 0.`s the option of mz 0.`nretur ter1e-8 P? x2 = 0.relattics
  4096. ?zz 0.relatti{,{<z 0.relattz 0.relatt?zz 0.relattisee set xticdtics
  4097. ?zdz 0.relatti{,{<dz 0.relattxz 0.relatt?z set xticdtics
  4098. yset xticdtics
  4099. ?zyz 0.relatti{,{<yz 0.relattyz 0.relatt?zyset xticdtics
  4100.  `set xticdtics
  4101. ?zdtz 0.relatti{,{<dtz 0.relattdtz 0.relatt?zdtz 0.relattiseey`set xticdtics
  4102. ?zytz 0.relatti{,{<ytz 0.relattytz 0.relatt?zytz 0.relat between single- aset xtics`ails.
  4103. d conorizona)
  4104.      commaItf E    sr moves te
  4105. inics
  4106. ?z= 0.  For xis laborizonalok l E    san be f thics
  4107.  set xtics`x axir moves teinics
  4108. ?zd= 0.  For xiel` command sets be ticssl` com antails.
  4109.  y,
  4110. mx2t wgetyhis ults othing for each of theion
  4111. rizons.
  4112. LID linex:
  4113.          set xion
  4114. rizons.
  4115. LID linex:
  4116.          set yion
  4117. rizons.
  4118. LID linex:
  4119.          set x2ion
  4120. rizons.
  4121. LID linex:
  4122.          set y2ion
  4123. rizons.
  4124. LID linex:
  4125.          set ?zz 0.relatabel {"<label?zdz 0.relatabel {"<lf>}
  4126.  bel {"<l<i{,{<z 0.relatbel {"<l<i{,{<dz 0.relatabel {"<lf>}
  4127.  
  4128.  B     term,t y2s?set termi
  4129.  whgffrted t 
  4130. LID linexr>}}
  4131.          show  willion
  4132.  ab satext windmand setsn be window honush btLIDress roughly ion
  4133. rizonl<fontnquirete file.hics
  4134.  set xtic l; set yion
  4135. rizon the nics
  4136. ?z= 0.  Forfontnquirete file.hics
  4137. ?zdz 0.rela; ics
  4138. ?zyz 0.rela` Please see `set xmtics` for details.
  4139.  zis command sets the label for the x2 axis. zmlease see `set xdata`.
  4140.  The `set xztics` command changes tics on the x2 axis to months of the year.
  4141.  Please see zet xmtics` for details.
  4142. rrange` command sets the hormd.ls.
  4143.  zis comPleasez2rangean strf `    byo computefor zonte seco byo omman
  4144. mand sets the lab
  4145. ` parametric mode.  Pleacs
  4146. zow zdlease see zet xrange` for details.
  4147.  The `set x2tics` command cozrols major (labelled) tics on the x2 axis.
  4148.  ti{ell
  4149. ?set y2{elltics` for dp bes` omofnd acointin{ellmmanoimoduloile.hgnuplot.luesessi`ano
  4150.  whai
  4151.  windowVMSont go `, r  TheEND-OF-FILEnute,0--60),
  4152.  windotic"stont ndardhai
  4153.  windowAtloaDOSis a t go `,i
  4154.  windowMS-DOSs a OS/2 rouAm
  4155.  Each n{ellics` for       sor being optio oueciait xels.  Li!nute,0--60y c$ai
  4156.  windowVMS) dtmenu b 4.nn degreeaowing wayabel, por the Sni
  4157. ?wgnduloframize ossibile.hgnuplot.Macros tase see `setontnxecuetyps :  {/[fontnamallyc"stonAtloaDOSisMS-DOSs a OS/2ot plot
  4158.  !and 
  4159.  
  4160. line cola `WGNUPLOT.lng ofg4is is xn modulo 7 e.hgnuplot.replaarks A/tiiable
  4161.  I! a file.
  4162.  
  4163.  ).  (Thenas useimilar n{ellizonalt tiy specif
  4164. xis i     im,ti
  4165.  mory.
  4166.  
  4167.  `licate ticlinacoi
  4168.  hoiwant to use =2rmu[OPEN]
  4169.  wgal m`,<xoffar data. ti char?surft o> chara,3]
  4170. ?   melimit phaurft o> for detthe LaTetsefu thmory.
  4171.  
  4172.  `4.` wgnuplot.inithed  Lins following wao workse ou` following waylearf6anmarwriting appliet
  4173. u` following wae second changes ohe contoontrol c th x, y marks and `aurft or det/timupdet/tim
  4174. ?.gnuplot
  4175. olors
  4176. nt to use =2rmu[w tics su <xoff>nckground color and lrftimeadlicate 
  4177. stScripth ix2tis`.mporary finyc"starks AtloaDOSes) alost wget`T,
  4178.  4=DASHDO labeSimilas) alosrted to d asScripth
  4179.     If the menu  followi`WGNUPLOTochrome`rthe mSni
  4180. ?ws supxoffihhe menu hole `WGNUPLOT.(is preAtloaDOSi
  4181.  A/tii(
  4182.  Each)TOSisMS-DOSswgetOS/2o    se tatonmEnt les` comunt to use is for
  4183.  enhanced   som Windoo d a`WGNUPLOT)labmajo:oiwaNOCWDRCthe levariabd usefuhrome    ix2i` savewgnuplot.ini
  4184. ?woff>t timhe clipboafollowi`WGNUPLOT.n file
  4185.  d asScripth If tvewgnuplot.inxecuetates/times.
  4186.  where xd asScrlicate 
  4187. s smants on top f by ptpts als fnot changeessi detaevarofg4isye date/tisthe ples` commaruy onretas coocroted tmilar to [O
  4188. porhere ihe `stmilar to [Ory.  ry as
  4189.  WGput` f) alonthe x al  clowingallyfor tinctio lease see `sety.  r beingis is x,lly (orititle
  4190. ?titl `set os
  4191. d   som Windoo tween sing(singfor tincti)
  4192.  To clear the label,t pmewnsteading the
  4193.  traildows directoenu fr beingimefmt
  4194. ?sre morat outnithedol nklts oorhere ihe `stmilar to [Or tics
  4195. ?tics
  4196. isy      ssse ou`the following wa
  4197. label,t pfmt
  4198.  
  4199.  SeePlease dows 3.1 menu rthe mS`r (ltsqtefor morat oS`r (ltsqtecharacter 
  4200. gfor tincti)
  4201.  To clear the labeloplot`Windo trai:t plot
  4202.  co-of(x)zer`r (ltsqt
  4203.  
  4204. ` tamalwVMSt plot
  4205.  co-of(x)zer`3.1 r (ltsqt
  4206. eacs
  4207. meters
  4208. eaeters
  4209. eae        im?      im? e  pdatethe `ta?pdatethe `ta?set g     s 3.lailt zaetersMIF Frdatethe `t4.` wgnuplot.i`Bordey okeyh wds
  4210. xis iet termi
  4211.  whg nom-rgin.  Ths oft termi
  4212. of
  4213.  a Souldputn showne characteh exalls `gnuplot` macro d to Eacables
  4214.  nr `splot`s.  It
  4215.  whlls `gnuplot`ar th majR to th
  4216.  whlls `gnuplot`arlermi
  4217. of
  4218.   clowingalsbsacro []t windoe.
  4219.  
  4220.  )l som Ws
  4221. xire
  4222.   clowingalsion ost wget temandiscellstenu  ues.  Sire
  4223.   clowingal
  4224. ntx, Thy2s?io lBsacketai{}onretas coxoff> emantop of
  4225.  puries lts oorhersonretas cot (tab) isele <xoff> or <ysrk out the<xoff> or `);ics` fisd to tles` commabe A si te si(cs` fisdMacros tak ovia`okeyh wd ssse ou`i t`
  4226. he outpu);iables
  4227.  timi movt engine
  4228.  of aracteroplone charactebfig`       ime, mm<ysrk out th th x, y );ics` ta time`changes te de`ear the  ase used tluet` wmyoontisosy.  Booontstants oonts0 150oontry.  Booontiffer,d`ault marks
  4229.  ovit v;iables
  4230.  ti` commaracteroplone charactebfig`       ie, mm;ics` stants es to ftle`mi
  4231. of
  4232.  bel
  4233.  
  4234.  The ;
  4235.  x, y, and  date/tiste
  4236.  lin` commandalcal jor texa parametric `splot`s.  It d per fi/ following wa ;
  4237. is is x,ldpulvt edetaise
  4238.  keyh wdsccess speciairti inon a xrandetaisre date/tisthn fi/ following wa el iox, Thy2s?ionretas cot (It imitedetaiseels
  4239.  on th The (ying ies toftime"p
  4240. one charact)
  4241. is isoairticisele et tot.iniin the timedatOTDOTtl fset  ou`i t`
  4242. hrks an/ following wa el i(ox, Thy2s?ionnngimefm defaulchantics
  4243. in ston acedtdate/timnre <rot.)rtiBracro on tas cot (It imitem to t, useimilaimi       size in e de`ear the  
  4244. ` tohn fi/ following wa el iCrlermi
  4245. retas cot (tab) iselrom ema in eparametts as one colmand lio
  4246. (tab) isele  plot 6 phe timedatOTDOTtl fset  ou`i/ follorks ai t`owing wa el iSemicrlermi
  4247. retas cot (tab) iselar the  ae commd.t` for miabel,t pBsacketai
  4248. retas co6 ph `Copy   sory amanag `set suplot` oby [EOS], d drplie
  4249. nt nhiestr xis lydefaulchantics
  4250. t (Itnotx,ldpulvx name an: {3,2}zer3 + 2iA of menu s    s  clowingalsuences ae x2he distinctioding space)e `set syntax`
  4251. (taabout thplied\npunewnste"man en .  ` coxoffthe distinctdranges swed innoies to uences tinctdranges s
  4252. xis la The must
  4253.  conterenu file xoffar coabelochromemermiihe `sttusefrteThuates/tiws:
  4254.  
  4255. - The mutdranges t plot
  4256.  co"d of diret t the macro set men.\nd of diret the first lin"or exampdows dit plot
  4257.  co-d of diret t the macro set men.tgif {<mode>}d of diret the first lint pon atgif {<mo'd of diret t the macro set men.\nd of diret the first lin'or exampdows dit plot
  4258.  co-d of diret t the macro set men.\nd of diret the first lint pB<scalences and
  4259.  the distinctdranges se `set s t ma,ldrGNUPsuppors laEE
  4260.  tl I agomncc"sulvx,ey fil,eetriT
  4261.  tits per p-Romai\\iinhe ttusefuio
  4262. (t     iecommat linter.sd t`r.sd`.c36andola `Wthe hle to ro namind exaont
  4263.  siis ieimilaon top ues.  
  4264.  e 30.ineiselxoff> or ot changon..
  4265. retassefrs othing f r.sd ?uor blPlease see `setuor bliret th/timene charac
  4266. l bte ime`chinhe tttimene charac
  4267. stScriassory as
  4268.  WGNUP  ou`i t` f its oour digine charac
  4269. mand setmorat oung op
  4270.  twocion a sets o-d of diron top f byder slai
  4271.  marere 0=g cooo u plpoungfit Egncets othing for each ofuor bl <nated by>k to thei t`
  4272. ?rn Rlevarianove
  4273.  `set xrmewe `show variables` command l date/tisth title selecte fonbles` comma s  ob <omecomingis itics
  4274. isy     ts oU`show variabtdate/timshing for each of<tdate/ti-d by> (rec wmy1.
  4275.  
  4276.  ec wmy2.
  4277.  
  4278.   e  }   )zer<o pretatio>{        {o pretatio>the levariab6 ph t ekh tec wmy1.
  4279.  selecteec wmy5>ts oU`show variables` comushing for each of<les` com-d by> er< `e
  4280.     -o pretatio>{  nly.  Both scales dw er2h scales dq ere wors (n(pi/2 -t0a1)(zlabel {"<f(x)zersse(w*x(zlabel {"<ssec(x)zersse(pi*x(/(pi*x(zlabel {"<It ta(t)zer(t =ero(zlabel {"< chp(t)zer(t >ro( ? t :>0zlabel {"< ch(a,b)zer(a < b( ? a :>bzlabel {"<seeb(n,k)zern!/(k!*(n-k)!(zlabel {"<ted3d(     )zersqrt(x*x+y*y+z*z)t pmajor ticsls.
  4281. tes` comunpi`izonalt tiy w varia with no p{,{< date/tisso `set for details.
  4282. ?ntebugzdleasebt sull date/tistth}
  4283.    h wi f byldpulvx ta time`cppors lagae `btdate/tim the graph wi f byldpulvx ta time`cppors l set ltylugnd,0--60).di insb` is u tohlaf mar    is unas) alos ( maOS oths4-3.2)
  4284. xis la"%g"h that du to'ine cf'`set ftelsh outrGNUPsuline colname an i(e.g , 200000 0.Eac"2")rteThua,xdtics` c 
  4285.  The d s    s outrGNUPmd.t`  ma4rotreshe botthgnuplot.rp)A h wi-arIf thes `set a 30hlenu cxranorcial
  4286.  for lab
  4287. `cs
  4288.         etc.
  4289.  The `set tics` ccs` c s quoted
  4290.  "%7.0f"ooo ut.iniimil
  4291.  e 30.ineiselxofme cold of  outpusinor ticsbere ffieab6 p maOS 4axis oAor whenlug:laarkp ma3 is pre maOS 4ax,eetrio p ma4's is pre hs4-3.2arks
  4292.   maOS 4ax,etics'sa 3nf'`rIftit speutrGNUPsulipuslsh"00 2
  4293. " xels.  Lit` tries"orm%f"ofor moeach0 defau     Put nex0rks t1 cold of  intsset xranicrosrted 
  4294. lenu cxrantScrienhance se `splot`s.  Itruy onretion
  4295.  d in
  4296.  whlry as
  4297.  WGplie
  4298. n'00',n'000',nf>}acter be to i
  4299. ?wgnuplnges rnd ay returns tChena
  4300.  a SzeroaxtScraisreuphe dt tics maOSmmaItf outpusinor ticsbere ffieab6 p maOS 4a1HELP.E maf  outpuut.
  4301.   the we used
  4302. dalcal jsefulxp(-x) /ti 
  4303.  =g  thate.hgnuplot.
  4304.  g es
  4305.  n is pvariabt aerms ofelop wi-arIf thes `seow.
  4306. rkpu`show variabtdate/ti
  4307. hpliede(x)zerx<-500 ?x0r:ulxp(x)cold of  intssete n isnexGautat lii(exp(-x*x()
  4308. n ad totical a,<ssec  t*xa:3man"quit.
  4309. rrpidsupporMi'
  4310.   ocr C 5d bhEacvon(ltyylugnl bociatvirtual 3-d %gh that du toine cf.
  4311. olors
  4312.  a S font, anhat ac"%.2gnis"%.1gnis"%.0gnis"%.g"h
  4313. retas c,oine cff> as o outrGNUPsuline c name andd,0--602range1e-4he z e-1labmame andu com
  4314. s format
  4315. line c WGNUP  ou%th that don thoutrGNUPsuline c WGNUP  ou%fh that ,iWGNUPLOT w rnd an the b foion
  4316. sMacros tak omethingnd exmmanoih wi arIf th xd aet
  4317.  g
  4318.  ,
  4319. cial
  4320.  for%3.mil%fh that sels
  4321.  on tsupporhgnuplot.l used
  4322. ddpuilvirtual Mi'
  4323.   ocr C, `Wd graph wi utrGNUPsul d pen VGA
  4324. ics` defau` comml ser.sde rteleasCGA, EGArks tVGAits per p
  4325. s formet
  4326.  execuat
  4327. lrecripten is in WindoMi'
  4328.   ocr C he plotsinsb` isup) is used
  4329.  ddpuilvirtual
  4330. to use the WI     indoTurbo C he plotsits per p-d
  4331.  thro d wi utrGNUPsultual
  4332. tVGAits` defapporVAX/VMS 4a7 C ddpuilvbyder (lab2.4ulchanhEacvopwor an pulvime`vir%gh that 
  4333. du toine cf.cal (Z) abacteh eline c WGo.
  4334.  
  4335.  You ly utrGNUPwed in     you  s o
  4336. lenu raabosof pxofme cold e K&R f all t/d the bsefau` comxoff> or%gh that  %Htory. as co6ees.  <xpitlnmeirast a reass-4hoff:36and prt looffaqon appliet
  4337. utio iss oourd e VAXI     %th that d6ees.  <xpitlnmeirast a reass-1ourd e VAX
  4338. f outpusinortw.
  4339. rnh}
  4340.   t matrols foio iss o and rio iueciauseimilais in W%3.mi
  4341. l%fh thZ) abactest a reass1mmanoih wi arIf th xd aet
  4342.  g
  4343.  ,cial
  4344.  for%3.mil%f
  4345. h that sels
  4346.  on tsups :e clipboVAXICb2.4uder (labnotxn: e,E,f,F,g,G utisded t i
  4347. ?walwefauenhanced somethinggnd exmma:  {g4is iG,et2ri0 degion
  4348. sMni
  4349. ?woff
  4350.    sr moves he clipbot aermsporVAX/VMS 5.2aC ddpuilvbyder (labbut hEacvosllot`ecuatt-60),pulvime`vir%g
  4351.  s quotedeassder (lab2.4wed innoiemechmman2ri0 degomethingnd exlack of wxir moveswed int2ri0 degion
  4352. sM
  4353.  whlti
  4354. ?woff>t moves he cl%g name andd,
  4355.  <xpitlnmiing that ts oULTRIX X11R3 hEacvolugn` comca     indoX11its per
  4356. t (IWthe hl"s theWr whe"
  4357. for bmmans flugnsrkmste
  4358.  linffieab6 pDEC'ssder (labtroX11R4ate.mmavbyder (las to tULTRIX ded wisrkminor tics.  Net
  4359.  g
  4360.  o wo  pe/tistu tohlailasitlsh ouluddeduphe dts als fX11insb` itailshe clDECae x2WGNUP he clMIT)ae x2evarofg oULTRIX_KLUDGE used
  4361. ddpuilts als fx11.timvsScrlicmajor ticsls.
  4362. kludgripth
  4363.   d intinting stonfors thppors la `e
  4364.     tHUGE uash outrGNUPsullevariab6 ph laNeXTtOSb2.0r    is un
  4365. as) alolicHUGE is format. ethe z e38n ad r bmhmmd of eow nehEacbve it rGNUPoung6 ph la2d btreshe bottNeXTtOSLP.E t.inilaila vallisnexHP<curvetrstth}
  4366.     ticse
  4367.  xgriedata    etc.
  4368. 'PG's the opafollowiHPGLits per
  4369.      inse see `setyniHPGL_t ae cold of      3.1 is b ist moves hoff> ose<curvetrsmmans fafollowiPCL5its per
  4370.      HPGL/2 hoff>indoes twet primhe plotscold of is format. vaas
  4371.  WGis in Wa 30 comuPCLe to lreplaarh laA/tiibtreshe w tics
  4372.  
  4373. off> 5 for minorn ade
  4374.  trail2WGNUPibile.iet
  4375. utiofnd .(ie heig/lef/lp`fying trailsScr),<ssec  CR defauldof 60 dLFndd,
  4376.  bdesheWg trairp)Aacvop wi-arIf tl urijor teng trailnt astScrianngimpysifile  T cooiofnd .acrosd to  windowa n{ellics` forppors l se E    stn ip-to-r bl fisdMx` fugz<ssec  ipbot r (labtarh laWWW
  4377.  xgrth scahttp://www.tscdtotmg th.edu/gnuplot
  4378. ajor (labmor of
  4379.  a Sfugz<is bug-gnuplot@dtotmg th.edu.
  4380.